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About This Guide 


Purpose 


The A Series Tape Management Programming and Operations Guide documents 
enhancements to the A Series tape management software. 


The guide discusses the following subjects in relation to these enhancements: 


@ New options for unloading tapes 


@ One new system command —HOLD (Hold Unit for Operator Use) —and a number 
of existing system commands that have been modified 


e Programming considerations, including the following: 
- Two new file attributes (AUTOUNLOAD and SCRATCHPOOL) 


— One new task attribute (LABELFORMAT) and modifications to two existing 
task attributes (HISTORYCAUSE and HISTORYREASON) 


~ Modifications to the SETSTATUS intrinsics 

- Modifications to the Work Flow Language (WFL) 

— Newsystem log entries and modifications to existing log entries . 
— Anew tape volume security attribute (SECURITYLABELS) 


e Data Management System IT (DMSII) considerations, including a new 
recommendation concerning dump tape directory maintenance and ways of using 
the SCRATCHPOOL attribute 


e TAPEMANAGER library implementation and operations. 


e@ ‘Tape label formats 


Scope 
This guide covers only those subjects related to the enhancements to A Series tape 


management software. It does not deal with aspects of this software that have not 
changed. : 


Audience 


This guide is intended for use by experienced users of A Series systems, including 
system administrators, operations center managers, operators, and system 
programmers. . 
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About This Guide 


Prerequisites 


The reader of this guide should possess some knowledge of the basics of A Series 
software and hardware. 


In particular, the reader is presumed to be familiar with tape management procedures 
on his or her system as they relate to his or her responsibilities. 


How to Use This Guide 


Some readers might choose to use only parts of this guide. However, all readers 
should begin by reading Section 1, “Overview.” This section provides an introductory 
summary of key points presented in the guide. When you have completed the overview 
section, refer to subsequent sections for additional information on topics related to 
your needs. 


Much of the information presented in this guide has been extracted from other A Series 
documents and then revised to reflect the tape management enhancements. For 
example, Appendix B, “Standard Tape Formats,” is based on Appendix G, “Standard 
Tape Formats,” of the A Series I/O Subsystem Programming Guide. Section 2, “System 
Commands,” presents revised versions of information from the A Series System 
Commands Operations Reference Manual as well as some text that is entirely new to 
that book. 


When it presents information that is based on another A Series book, the Tape 
Management Guide follows the style and format of the base book. Appendix B is 
presented in the style and format of the A Series I/O Subsystem Programming Guide. 
Section 2 follows the'style and format of the A Series System Commands Operations 
Reference Manual. 


Each section (or subsection, as appropriate) of this guide begins with a note that 
indicates the base book of the text — that is, the book on which the material is based. 


Organization 


vi 


This guide provides an overview section that is intended for all readers, followed by 
four sections that each discuss a particular aspect of tape management on A Series 
systems. Appendixes provide related information. 


This organization enables the reader to focus on information pertinent to how he or 
she uses the system. For example, system operators can concentrate on the section that 
deals with system commands and the appendix that presents new system messages, 
and avoid the discussions that relate to programming and database management. 
System administrators might choose to read the entire guide. 


In addition, a glossary, a bibliography, and an index appear at the end of this guide. 


Section 1. Overview 


This section presents highlights of the topics discussed in this guide. 
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Section 2. System Commands 


This section provides detailed information on commands that operators might use to 
operate the system. 


Section 3. Programming Considerations 


This section provides detailed information for programmers. 


Section 4. DMSII Considerations 


This section provides detailed information for users of DMSII. 


Section 5. TAPEMANAGER Library Implementation 


This section discusses the functions in a TAPEMANAGER library, required procedures 
of a TAPEMANAGER library, exported master control program (MCP) procedures used 
in tape management, and operations that interact with the TAPEMANAGER library. 


Appendix A. System Messages 


This appendix presents system messages that are generated by the MCP as a result of 
the enhancements to the tape management facilities. 


Appendix B. Standard Tape Formats 


This appendix presents a number of standard tape formats. 


' Appendix C. Understanding Railroad Diagrams 


This appendix explains how to read the syntax diagrams used in the guide. 


Related Product Information 


A Series ALGOL Programming Reference Manual, Volume 1: Basic 
Implementation (8600 0098) 


This manual describes the basic features of the Extended ALGOL programming 
language. This manual is written for programmers who are familiar with programming 
concepts. 


A Series Binder Programming Reference Manual (8600 0304) - 


This manual describes the functions and applications of the Binder, an efficiency tool 
that reduces the need to recompile an entire program when only a portion of the 
program has been modified. This manual is written for programmers who are familiar 
with programming language concepts and terms. 
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A Series CANDE Operations Reference Manual (8600 1500) 


This manual describes how CANDE operates to allow generalized file preparation and 
updating in an interactive, terminal-oriented environment. This manual is written for 
a wide range of computer users who work with text and program files. 


A Series DMSII Data and Structure Definition Language (DASDL) 
Programming Reference Manual (8600 0213) 


This manual provides instructions for defining and maintaining a Data Management 
System II (DMSII) database using DASDL. This manual is written for database 
administrators and staff. 


A Series DMSII Technical Overview (8600 1641) 


This overview describes the Data Management System IT (DMSII) environment, which 
includes DMSII databases and software. This overview is written for end users, system 
programmers, database designers, and database administrators who need information 
on creating, changing, restoring, accessing, and maintaining a DMSII database. 


A Series DMSII Utilities Operations Guide (8600 0759) 


This guide shows you how you can use the Data Management System IT (DMSID) utility 
programs. These programs allow you to perform such database management tasks 

as initialization, reorganization, backup, recovery, verification, and remote database 
backup. This guide is written for database administrators and programmers who are 
responsible for database integrity and recovery. 


A Series File Attributes Programming Reference Manual (8600 0064) 


This manual contains information about each file attribute and each direct I/O buffer 
attribute. The manual is written for programmers and operations personnel who need 
to understand the functionality of a given attribute. The A Series I/O Subsystem 
Programming Guide is a companion manual. 


A Series GETSTATUS/SETSTATUS Programming Reference Manual 
(8600 0346) 


This manual explains how to use the various GETSTATUS and SETSTATUS calls used 


in the DCALGOL programming language. This manual is written for experienced 
ALGOL programmers who are involved with data communications. 


A Series I/O Subsystem Programming Guide (8600 0056) 


This guide contains information about how to program for various types of peripheral 
files and how to program for interprocess communication, using port files. This guide is 
written for programmers who need to understand how to describe the characteristics of 
a file in a program. The A Series File Attributes Programming Reference Manual is a 
companion manual. 


A Series Report Program Generator (RPG) Programming Reference Manual, 
Volume 1: Basic Implementation (8600 0544) 


This manual describes the basic features of the RPG programming language, including 
both RPG J and RPG II dialects. This manual is written for application programmers 
who are familiar with programming concepts. 
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A Series RoboHost A Operation, Installation, and Administration Guide 
(8600 1740) 


This guide describes how to install and operate the RoboHost A TAPESERVER library 
on an A Series host system. It includes information needed to oversee cartridge tape 
library (CTL) system operation from the RoboHost A software. 


A Series RoboHost A Programming Guide (8600 1609) 


This guide provides a detailed definition of the RoboHost A TAPESERVER library 
functions and is intended as a reference document for developers of tape management 
systems (TMSs) and user programs that access the cartridge tape library (CTL) 
database. 


A Series Security Administration Guide (8600 0973) 


This guide describes system-level security features and suggests how to use them. 
It provides administrators with the information necessary to set and implement 

effective security policy. This guide is written for system administrators, security 
administrators, and those responsible for a and implementing security 


policy. 
A Series Security Features Operations and Programming Guide (8600 0528) 


This guide describes the security features available to users and provides instructions 
for their use. This guide is written for users who are responsible for maintaining the 
security of their individual programs and data. 


A Series System Commands Operations Reference Manual (8600 0395) 


This manual gives a complete description of the system commands used to control 
system resources and work flow. This manual is written for systems operators and 
administrators. 


A Series System Messages Support Reference Manual (8600 0429) 


This manual presents operating system error messages and explains the most likely 
cause of each error and the most effective response to each message. This manual 
is written for operators and programmers responsible for the operation of A Series 
systems, and for the resolution of error conditions on those systems. 


A Series System Software Support Reference Manual (8600 0478) 


This manual describes a number of facilities used for system monitoring and 
debugging, including BARS, DUMPANALYZER, LOGANALYZER, and LOGGER. It 
also describes the format of the SUMLOG file. This manual is written for system 
support personnel and operators. 


A Series SYSTEMSTATUS Programming Reference Manual (8600 0452) 


This manual documents the SYSTEMSTATUS intrinsic of the master control program 
(MCP). The SYSTEMSTATUS intrinsic provides information that can be used to 
efficiently monitor the performance of a running system. This manual is written for 
systems programmers. 
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A Series Task Management Programming Guide (8600 0494). 


This guide explains how to initiate, monitor, and control processes on an A Series 
system. It describes process structures and process family relationships, introduces the 
uses of many task attributes, and gives an overview of interprocess communication 
techniques. The A Series Task Attributes Programming Reference Manual is a 
companion manual. 


A Series Work Flow Language (WFL) Programming Reference Manual 
(8600 1047) | 


This manual presents the complete syntax and semantics of WF L. WFL is used 

to construct jobs that compile or run programs written in other languages and 

that perform library maintenance such as copying files. This manual is written 

for individuals who have some experience with programming in a block-structured 
language such as ALGOL and who know how to create and edit files using CANDE or 
the Editor. : 


X 8600 0940-000 


Contents 


About This Guide .......... 0... . cee ee ee eee V 


Section 1. Overview 


Using Scratch Pools .......... SERS SESS eels yeas 1-2 
Using the Scratch Pool Concept in System Operations . 1-2 
Using the Scratch Pool Concept in Programs ....... 1~3 
Using the Scratch Pool Concept in DMSII ......... 1-5 

Controlling Automatic Tape Unloading ................... 1-5 
Controlling Automatic Unloading through System 


UPealOns.: s.2245 hose etm ie we wet See es 1-6 
Controlling Automatic Unloading through Programs... 1-6 
Examining a Tape before It Is Assigned................... 1-7 
Purging Tapes Synchronously ..... ee rer are ee 1-8 
Storing Security Attribute Information in Tape Labels ........ 1-8 
Using the ANSI87 Tape Label Format ..................- 1-9 
Controlling Tape Label Formats with System Commands 1-9 
Controlling Tape Label Formats through Programs... . 1-10 
Ignoring Tape Expiration Dates ..................-....-- 1-10 
Using New System Log Entries and Enhanced Existing Log 
ENUGS:. 6:5 c2032.0) oe rs Go ao ew el akg a a we eS 1-11 
Implementing Customized Tape Management Systems ....... 1-12 
Calling Standard Exported Procedures ............ 1-13 
Controlling Tape Usage .. 1... .... cee ee eee 1-13 
Installing a TAPEMANAGER Library..................... 1-13 


Section 2. System Commands 


HOLD (Hold Unit for Operator Use).............. 2-2 


MODE: (UME IMOGE) 26° 2-8 sen a oiste ar Higa Saw tetera 2-4 
OL (Display Label and Paths).................. 2-8 
OP (OBHONS) 05.0205 2 osha ahaered ee See RAGS 2-21 
OUC(OUTDUE IIE) oz 8 eas 6 bee oil dunia co aoe Sabre ee 2-33 
PER (Peripheral Status). ........... 0000 eee eee 2-37 
PG (Purge) and PGL (Purge and Lock)............ 2-43 
SEND (Send Message)... 0... 0... cee eee ee eee 2-47 
SN (Serial Number) and SNL (Serial Number Lock) .. 2-56 
SYSOPS (System: Options) 364 pase ew arene a ess 2-59 


Section 3. Programming Considerations 


File Attributes: «20:24 2.35 bu 4b 3 Seeks bec eee hal led 3-1 
AUTTOQUNEQGAD: oie a o75 sce eA ke He ore dene 3-2 
SCRAICHPOOL: oa ox do Ran eo coreae ae a 3-5 


8600 0940-000 | xi 


Contents 


xii 


HISTORY CAUSE. i655 Gece ye ese nee oe eb Ale hoes eae 
FISTORTREASON sp iheb das. ee eae Staal 
SETSTATUS Changes .......... op Mia natinetads Gel phan a 
SEND TAPEMANAGER and SEND TAPESERVER Calls 

HOLD Call.25-¢iek hem oe waae hos Oe et ee Re 

PG and: PSU Calissyc0 awawewete hha as eine ees 
SNvand:SN& Calls since Stee nie ey en we eae oe 

Security Enhancements ............. 00. cee eee eee eee 
SECURITYLABELS Volume Attribute ............. 
Establishing the Volume Directory Entry ...... 

Writing Files to the Volume ............... 

Reading from the Volume..............-6. 

ANSI87 Tape Format... ..... 0... eee eee eee 

Tape Management Enhancements in WFL ................ 
Using File Attributes .......... 0... ce ee eee eee 

ARCHIVE Statements ......... 2.0.0 cee eee ene 

ARCHIVE Statement Options ...............0..- 

COPY or ADD Statement ........... 0.2.0 ee 

Specifying File and Tape Volume Attributes ........ 

VOLUME Statement ......... 0.000 cee ee eee 

Logging Enhancements.............-. 000 ce eee cereus 

| LOGANALYZER Output Ilustration for VOLUMES 


O DON 2:64 wget iow Coe ew Ree See een arene Ya 
Major Type 1—Minor Type 5: File Open Entry 

(LOGOPEN TYPE ad cae tat ne eeee oe Se ddewen 
Major Type 1—Minor Type 6: File Close Entry 

(LO GCEOSE IVP E) fig et ece ae oe eet ce pete 
Major Type 2—Minor Type 24: CLU Hardware Report 

(CLUHWREPORT)............ ee ee ar 
Major Type 6-Minor Type 3: SETSTATUS Call 

(EOGSEISTAL) < S45 Pat aenieessitvad« ahead 
Major Type 15—Minor Types 1-5, 12, 13: Volume 

Status Entry (LOGMAJVOL) ..............05. 
Major Type 26: Tape Library Entry 

(LOGMAJ MEDIALIB) .....054 26 6 dice cee eee: 


DMSIlI Considerations 


Tape Management Enhancements in the Technical Overview .. . 
Tape Management Enhancements in DMSII Utilities ......... 
Tabie-GF CONTENIS: coed sca atewducmep ree tad Gs 


VISIBLE DBS Commands................ 00005 
AUDIT SCRATCHPOOL Command .............. 


4-3 


8600 0940-000 


Section 5. 


TAPEMANAGER Library Implementation 


TAPEMANAGER Functions for TMS Design............... 
Event and Status Information Retrieval for TMS Design ...... 
' Monitoring Tape Usage Events ................ 
Monitoring Current Tape Status................ 

Initiating Programmatic Tape Operations ......... 
CALL_TAPEMANAGER Procedure.............. 

General Considerations for TAPEMANAGER Libraries ....... 
TAPEMANAGER Error Handling...................04-. 
Fault Handling within TAPEMANAGER .......... 

Error Handling by the MCP .................. 

Security Considerations... . 0.0.0... 0... eee eee 
Interaction with the MCP ...............0 0. eee eee 
TAPEMANAGER Library Start Up and Shut Down.... 

SIgtine Wp: 2dtaenee Ma deeaees- etal Fes 

SHURING DOWD: si:a thie o Rw dine Move eee 

Opening Files........ er a ae eee re ee 
CHECK_TAPE_ASSIGNMENT............. 
CHECK_TAPE_UNIT_ASSIGNMENT ........ 
CHECK. TAPE REOPEN sicw.c.ccers gh wanes 

Purging Tape Volumes ............-.-.00000- 


Handling Programmatic Calls to the TAPEMANAGER 


EDiaIV al 5c dedamert eee fai atk ia Ran a eae 

Exported TAPEMANAGER Procedures .................. 
CHECK_TAPE ASSIGNMENT 0.2.2 300s ee ae es 
CHECK. (APE PURGE. oae3 date Gu tere peta s 
CHECK. TAPE REOPENS ore toa ean oie eee 
CHECK_TAPE_UNIT_ASSIGNMENT ............ 

CONTROL INTERFACE sovicn 2s atud dado a gia 
PROGRAM: INTERFACE 4 i wever taeew ah ee Nig 

Sample TAPEMANAGER Library............... 

Exported MCP Procedures for Tape Management .......... 
CALL_TAPEMANAGER Procedure ...................-.. 
Operations Interface to the TAPEMANAGER Library ........ 
Installing the TAPEMANAGER Library........... 

Initiating the TAPEMANAGER Library ........... 

Inspecting the TAPEMANAGER Status........... 
Terminating the TAPEMANAGER Library ......... 


Temporarily Disabling Use of the TAPEMANAGER 


LEIDER ena shyt ahead aoe ve eared eR oars 


Responding to Processes Waiting on the 


TAPEMANAGER Library..............2000- 


Replacing the TAPEMANAGER Library with a Newer 


VEISION vs ened £4 oes S05 cae Wigs Saat eons 


Appendix A. System Messages 


8600 0940-000 


Contents 


: 5-3 
‘ 5-4 
: 5-5 
; 5-6 
, 5-6 
, 5-7 
: 5—7 
, 5-8 
: 5-9 
9-9 
: 5-10 
i 5-11 


5-11 


> S12 
. 5-14 
. 6-15 
. 6-15 
. §18 
. 5-20 
. §21 


: 5-23 
; 5-23 
: 5-25 
: 5-30 
: 5-32 
: 5-34 
: 5-37 
‘ 5-39 
, 5-41 
; 5-52 
: 5-53 
, 5-55 
; 5-55 
5-56 
; 5-56 
: 5-57 


5-58 
5-59 


i 5-60 


xill 


Contents 


XIV 


Appendix B. Standard Tape Formats 


* WUnlabeled Tapes 2-siaci ee ease owes een Nee see ee B-1 
ANSI X3.27-1969 (ANSI69) Tapes ..................05. B-2 
ANSI X3.27-1987 (ANSI87) Tapes ................-000.4 B-8 
B:3500-USASI Tapes 00.) stata wos eee beh eed B-17 
B:5900 [apes sions ee Ga Cae oe Pa ae ee aes es B-19 

ALGO Piles 4.4666 howd ouee 6.4 thee ea eS B-20 - 
COBOL AFUGS on enh oa Vee ta ieee he ee ees B-20 


Appendix C. Understanding Railroad Diagrams 


What Are Railroad Diagrams? ............... 00000 ee eee C-1 

Constants and Variables... ......... 2... eee eee C-2 

CONSH GINS 53 wine ote nk eee te ese ee oe C-2 

Following the Paths of a Railroad Diagram ................ C-5 

Railroad Diagram Examples with Sample Input: ............ C-6 

GIOSSANY fecoi'ds nea nerd aand eee cee eee dative wewee tn weaed 1 
BibNGPTaphY soci caer dieades te Bea eee ee ee Sl eeee aoe eae 1 
INGON cnt date ea cet eee eye eee e ne Res eae ees 1 


8600 0940-000 


Figures 


8600 0940-000 


VOLUMES Option Output... 0.0... 0c ccc cececceuceeeceeeees 


The Tape Management System (TMS) Environment................ 
TAPEMANAGER Library Status Change Diagram ................4. 
Information Flow in CHECK_TAPE_ASSIGNMENT.............0058. 
Information Flow in CHECK_TAPE_UNIT_ASSIGNMENT............ 
Information Flow in CHECK_TAPE_REOPEN ..............00005. 
Information Flow in CHECK_TAPE_PURGE ............. 000 ea eu. 


Unlabeled Single-File-Volume and Unlabeled Multifile-Volume Formats . . 
ANSI69 Single-File, Single-Volume Format... ........ 2.00 cee eeee 
ANSI69 Multivolume-File and Multifile-Volume Formats ............ 
ANSI69 Multifile, Multivolume Format........... LBS hi eis dt td Sac: tye 
ANSI69 Volume Header Formats .......... 0c ee eee ee ee ee ees 
ANSI69 File Header 1 Format ...... 0.0... 0c cee eee eee 
ANSI69 File Header 2 Format ............ cc cee ee ee eens 
ANSI69 User Header and Trailer Label Formats ...............08. 
ANSIG9: Scratch Tape Format::..24 225 san sig wi beeweiwan ce lea 
ANSI87 Multivolume-File and Multifile-Volume Formats ............ 
ANSI87 Multifile, Multivolume Format. .......... 2.0... 0 ce eens 
ANSI87 Volume Header 1 Format. ....... 0.0... 0.0 cece ee eee 
ANSI87 Volume Header 2 and Volume Header 3 Formats........... 
ANSI87 File Header 1 Format ... 0.0... 20... ccc ee ee ees 
ANSI87 File Header 2 Format ...... 0... 0... ccc ee ee eee 
ANSI87 File Header 3 Format ...... 0... 0... cece ee eee 
ANSIS7 Scratch Tape FOrmMatl s.:sa.e0c 5 hee Shave eS eu eee eeS 
B 3500 Volume Header Format ......... 0... cee eee eee 
B 3500 File Header 1 Format .......... 00 cece ec cece we cee eas 


Railroad Constraints .. 0.0.0... cece ec eee eee ence eee eee enes 


XV 


xvi 8600 0940-000 


Tables 


2-1. AUTOUNLOAD Option Effects........ Shed Gate Ae ite eh Soe 2-6 
3-1. Comparison of File Attribute Types to WFL Attribute Types........... | 3-44 
3-2. Major Type. l-Minor Type S's eves baw nae eke eee awa da ends 3-56 
3-3. Major Type 1—Minor Type6 ... 2... ee ee ee ee 3-60 
3-4. Major Iype'6—Minor l¥pe-S os essed ee ew Ks Meee ed ae ed ka rem 3-68 
3-5. Major Type 15—Minor Types 1 through 5,12, and 13.............. 3-70 
4-1. Tape Management Enhancements to DMSII..............0 00-00] 4-1 
5-1. Log Entries for Tape Management......... AS Soni ate Ne Cee th SS 5-5 
5-2. Exported TAPEMANAGER Procedures .........00 0c eee ue eeeeees 5-24 
A-l. Metatokens Appearing in Message Listings ..........000 eee euaee A-2 
Bl. BCL Characters for B 5500 Tape Labels .............. 0.0 eee B-19 
B-2. B 5500 Tape Label for ALGOL Files ......... 0. c eee ee eee B-20 
B-3. B 5500 Tape Label for COBOL Files .......... 0... cece eee eee B-20 


~ 8600 0940-000 Xvi 


XVili | 8600 0940-000 


Section 1. 
Overview 


This guide presents a number of enhancements to the A Series software. These 
enhancements provide additional flexibility in the ways installations can manage their 
data that is stored on tape. 


The enhanced tape management facilities enable you to perform the following 
operations: 


e Logically group scratch tapes in scratch pools, each with a unique identifier. A 
scratch pool is a group of tapes that have been given a name. This capability means 
that when you create a new tape volume, you can provide either of the following 
types of instructions concerning the tape to be used: 


— Direct the system to use a particular tape by supplying a specific serial number. 
— Specify that the system can use any tape from a given scratch pool. 


-@ Exercise greater control over how file-close operations affect tape drives. 
Specifically, you can designate which of the following actions the system is to take: 


— Rewind the tape. 
— Rewind the tape and then unload it. 
e Examine a tape before the master control program (MCP) assigns it to a task. 


@ Maintain the settings of tape volume security attributes in the tape label rather 
than in the volume directory so that you can more easily transfer the tape among 
hosts in a multihost environment. This enhancement is available only on systems 
with the InfoGuard security enhancement software for A Series systems. 


@ Read and write tapes in ANSI X3.27 1987 (ANSI87) format as well as tapes in 
ANSI X3.27 1969 (ANSI69) format. 


e@ Read tapes in other formats supported by the A Series software. 


e Specify that expiration dates read from tape labels are to be ignored. (By default, 
the MCP treats a write-enabled tape as a scratch tape if its expiration date has 
passed.) 


@ Use modified versions of system log entries. 


e@ Use enhanced tape management interfaces. 


The remainder of this section describes these capabilities and the means by waleh you 
can invoke them. Subsequent sections provide detailed documentation. 
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Using Scratch Pools 


Scratch pools enable you to group scratch tapes under a common identifier. Rather 
than supplying an individual serial number to identify a particular tape, you can 
specify a scratch pool name to enable the system to request or select any tape from that 
scratch pool. 


You can create scratch pools according to any criteria you choose. For example, you 
could create a scratch pool for each of the following types of tapes: 


e Tapes of a given media type 

@ ‘Tapes whose labels specify a given account number 
@ Dump tapes 

e Archive tapes 


You can specify a scratch pool in system commands, in programs, and in Data 
Management System II (DMSII) utilities. The scratch pool identifier appears in the 
RSVP request issued to the operator. 


A scratch pool name contains from 1 to 17 alphanumeric characters. 


Using the Scratch Pool Concept in System Operations 


System operators can use the scratch pool concept in a variety of situations including 
the following: 


e To assign a tape to a scratch pool, an operator can provide a scratch pool name as 
part of the tape-purging process. 


@ To request a tape from a specific scratch pool, an operator can specify the scratch. 
pool name in the WFL statements COPY or ADD and ARCHIVE. 


e An operator can override an earlier scratch pool assignment with a file equation. 
The following system commands are affected by the scratch pool concept: 


OU (Output Unit) 

PER (Peripheral Status) 

PG (Purge) and PGL (Purge and Lock) | 

SN (Serial Number) and SNL (Serial Number Lock) 


To purge a tape and assign it to a scratch pool, use a variation of the PG (Purge) 
system command. To purge a tape, assign or change its serial number, and assign it to 
a scratch pool, use the SN (Serial Number) system command. 


See Section 2, “System Commands,” for additional details on the means by which 
operators can create and point to scratch pools in system commands. See “Tape 
Management Enhancements in WFL” in Section 3 for information on how to specify 
scratch pools in WFL statements. 


8600 0940-000 


Overview (cont.) 


Examples 
The following examples illustrate how operators can assign tapes to scratch pools. 


e To purge a tape on unit 110 and assign the tape to a scratch pool named 
ACCOUNTING, enter the following PG (Purge) system command: 
PG MT 118 SCRATCHPOOL = ACCOUNTING 
e To purge a tape on unit 65 and assign the tape to a scratch pool named BACKUP 
enter the following PG command: 
PG MT 65 POOL = BACKUP 


e To purge a tape on unit 34, assign the serial number PART! to that tape, and 
assign the tape to a scratch pool named MANUFACTURING, use the following SN 
(Serial Number) system command: 


SN MT 34 PART1 POOL = MANUFACTURING 


e To purge a tape on unit 114, assign the serial number 12345 to that tape, and 
assign the tape to a scratch pool named DEVELOPMENT, use the following SN 
command: 


SN MT 114 12345 SCRATCHPOOL = DEVELOPMENT 


The following examples illustrate how an operator can request a tape from a scratch 
pool. 


e To copy the file PAYABLES from disk PACK to any tape in the ACCOUNTING 
scratch pool, enter the following WFL COPY statement: 


COPY PAYABLES AS PAYABLES FROM PACK TO ACCOUNTING 
(KIND = TAPE, SCRATCHPOOL = ACCOUNTING) 


e To override an earlier specification that the tape output from a particular process 
be written to the RESEARCH scratch pool, enter the following OU (Output Unit) 
system command to direct output from that process to whatever tape is currently 
mounted on unit 116: 


<mix number> OU MT 116 


Using the Scratch Pool Concept in Programs 
Programmers can use the scratch pool concept in a variety of situations: 


e By specifying the SCRATCHPOOL file attribute in file-assignment statements to 
ensure that when a tape file is created, the physical tape used to store that file is 
from a specific scratch pool. . 


e By specifying the SCRATCHPOOL file attribute in the Work Flow Language (WFL) 
statements COPY or ADD and ARCHIVE. This file attribute changes the syntax of 
only the WFL programming language. 
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e By specifying the SCRATCHPOOL file attribute in the DUMPALL utility COPY 
command. 


e By defining a scratch pool for the destination of a task request to the FILECOPY 
utility. 


Examples 
The following examples illustrate how programmers can use the scratch pool concept. 


e The following ALGOL statement specifies that when a file is opened and a new 
tape is to be written, the output is to be written to a tape from the ACCOUNTING 
scratch pool: 


REPLACE F.SCRATCHPOOL BY "ACCOUNTING."; 


This command takes effect when the system is ready to write tape output. The 
results of the command depend on the circumstances existing at that time, as 
follows: 


-— Ifatape from the ACCOUNTING scratch pool is currently mounted, the file is 
assigned to that tape. 


— Ifno tape is currently mounted, or if none of the currently mounted tapes is 
from the ACCOUNTING scratch pool, the system displays an RSVP request 
(MSRFOUTS30) on the operator display terminal (ODT). The following is an 
example of this request: 


F REQUIRES MT #1 SCRATCHPOOL = ACCOUNTING 
The operator can then perform either of the following actions: 


o Mount a tape that has been assigned to the ACCOUNTING scratch pool. 


o Purge a tape and assign it to the ACCOUNTING scratch pool as described 
and illustrated in “Using the Scratch Pool Concept in System Operations” 
later in this section. 


See Appendix A, “System Messages,” for information on MSRFOUTS0 and 
other messages generated by the MCP that deal with the tape management 
facilities. 


e The following WFL statement copies the file X from disk FRONT to tape BACK in 
the TEST scratch pool: 
COPY X FROM FRONT (PACK) TO BACK (SCRATCHPOOL=TEST) 
e The following specification in a DUMPALL request copies the file FILEONE to 
tape TAPE/FILEONE in the DEFAULTTAPE scratch pool: 


COPY FILEONE TO TAPE/FILEONE 
(KIND = TAPE, SCRATCHPOOL = DEFAULTTAPE) 


See Section 3, “Programming Considerations,” for additional information on the means 
by which programs can manipulate scratch pools. 
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Using the Scratch Pool Concept in DMSII 


Users of the Data Management System II (DMSII) can use the SCRATCHPOOL file 
attribute instead of the SERIALNO option when they back up a database to tape. 


DMSII users can also use the AUDIT SCRATCHPOOL command in the VISIBLE DBS 
utility to change the SCRATCHPOOL attribute for audit tape options. 


Examples 
The following examples illustrate how users can designate scratch pools in DMSII. 


e The following DMUTILITY command dumps the database to a tape in the TEST 
scratch pool: 


OFFLINE DUMP = TO TAPEX (SCRATCHPOOL = TEST) 


e@ The following COPYAUDIT command copies the audit file TESTDB/AUDIT1 from 
pack USER to a tape in the ACCOUNTING scratch pool: 


COPY TESTDB/AUDIT1 ALL FROM PACK = USER TO TAPE SCRATCHPOOL = ACCOUNTING 


See Section 4, “DMSII Considerations,” for additional details on how DMSII users can 
manipulate scratch pools. 


Controlling Automatic Tape Unloading 


You can control the actions taken when the MCP either releases a tape drive from 
use or performs a reel switch from the unit. By default, the tape is rewound but not 
unloaded in both cases. 


You can override this default procedure by invoking automatic-unload mode as 
described in the following paragraphs. When automatic-unload mode is in effect, the 
tape drive rewinds the tape. The system then automatically unloads the tape unless the | 
unit is a quarter-inch cartridge. (Since a quarter-inch tape drive does not physically 
eject the tape, the tape drive unwinds and untenses the tape so that the operator can 
unload it.) 


The following methods enable you to control when automatic-unload mode is or is not 
in effect: 


e You can use the MODE (Unit Mode) AUTOUNLOAD system command to define 
the automatic-unload mode of a particular drive as either ON or OFF. 


e At run time, you can use the AUTOUNLOAD file attribute to define the 
automatic-unload mode for a file as ON or OFF either to override a previous MODE 
AUTOUNLOAD command or to unconditionally force automatic tape unloading. 
The AUTOUNLOAD file attribute is valid in the WFL statements COPY or ADD 
and ARCHIVE and in file-equation statements. 
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e@ In addition to ON or OFF, you can assign the value DONTCARE to the 
AUTOUNLOAD file attribute. This value causes the behavior of tape file close 
operations to be defined by the most recent MODE AUTOUNLOAD system 
command for the drive. DONTCARE is the default value of the attribute. 


See Section 3, “Programming Considerations,” for additional information on the 
MODE AUTOUNLOAD system command and the AUTOUNLOAD file attribute. 


Controlling Automatic Unloading through System Operations 


An operator can control automatic unloading of tapes by using the MODE (Unit Mode) 
system command in the form MODE MT AUTOUNLOAD. This command sets the 
automatic-unload mode of a given tape drive to either ON or OFF The default setting 
is OFF. 


The automatic-unload mode setting of a drive is preserved across halt/loads, but can 
be overridden by the AUTOUNLOAD file attribute value of a program or library 


maintenance task. See “Controlling Automatic Unloading through Programs,” next in 
this discussion. 


Examples _ 
The following examples illustrate the MODE system command. 


e@ To define the automatic-unload mode of drive 9 as OFE enter the following 
command: 


MODE MT 9 AUTOUNLOAD OFF 


e Toset the automatic-unload mode of drive 6 to ON, enter the following command: 
MODE MT 6 AUTOUNLOAD. ON 


See Section 2, “System Commands,” for additional information on the means by which 
operators can manipulate the automatic unloading of tapes. 


Controlling Automatic Unloading through Programs 


Programmers can use the automatic unloading capability in the following ways: 


e By specifying the AUTOUNLOAD file attribute in a program to explicitly invoke 
automatic unloading of a tape as follows: 


AUTOUNLOAD File 


Attribute Value Action 

OFF Tape rewound but not unloaded 

ON Tape rewound and unloaded 

DONTCARE Depends on whether automatic-unload mode has been set to 


ON by a MODE (Unit Mode) system command, described earlier 
in this discussion 
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If the AUTOUNLOAD file attribute conflicts with the AUTOUNLOAD mode value, 
the file attribute takes precedence. 


e By specifying the AUTOUNLOAD file attribute in any of the WFL statements 
COPY, ADD, or ARCHIVE. 


e By specifying AUTOUNLOAD in defining the destination of a task request to the 
FILECOPY utility. 


Examples 


The following examples illustrate how programmers can use the automatic unloading 
capability. 


e The following WFL COPY statement copies the file X from disk PACK as the 
file XX on tape T. The AUTOUNLOAD attribute specifies that the tape is to be 
rewound and unloaded. 


COPY X AS XX FROM PACK TO T(AUTOUNLOAD=ON) 


e The following specification in a task request to the FILECOPY utility invokes 
automatic rewinding and unloading of the tape. 


FILES (= FROM DISK) TO WEEK36 (SCRATCHPOOL=BACKUP , AUTOUNLOAD=ON) 


See Section 3, “Programming Considerations,” for additional details on the means by 
which programs can manipulate the automatic unloading of tapes. 


Examining a Tape before It Is Assigned 


HOLD (Hold Unit for Operator Use) is a new system command that enables you to 
mount and look at a physically unlabeled tape before the MCP can assign it to a task. 
This command enables you to decide what you want to do with the tape before a task 
can assign it. That is, you can examine the label, purge the tape, and so on, before a 
program uses the tape. 


You can also use the HOLD command to remove the HOLD restriction. 


Examples 
The following examples illustrate the HOLD command. 
e@ To hold a tape that is located on unit 15, enter the following command: 


HOLD MT 15 


@ To remove the HOLD restriction, enter the following command: 


HOLD - MT 15 
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Purging Tapes Synchronously — 


When you use a PG (Purge), PGL (Purge and Lock), SN (Serial Number), or SNL 
(Serial Number Locked) call to the SETSTATUS intrinsic, you can specify that the tape 
is to be purged synchronously with the calling task —that is, that the task is to wait for 
the operation to complete before proceeding. 


The advantage to a synchronous tape purge is that the success or failure of the call is 
returned to the task, which can then proceed appropriately, based on that outcome. 
The disadvantage is that processing of the task is interrupted until the success or 
failure of the call is returned. 


See “PG and PGL Calls” and “SN and SNL Calls” in Section 3 for information on 
the parameter bit that controls whether these calls purge the tape synchronously or 
asynchronously. 


Storing Security Attribute Information in Tape Labels 


A new volume attribute, SECURITYLABELS, enables users to maintain the settings of 

- security attributes in the tape label rather than in the volume directory. When this 
information is on the tape itself} the tape is more easily transferred among hosts in a 
multihost environment. 


The SECURITYLABELS attribute is controlled by the Work Flow Language (WFL) 
VOLUME statement. The following criteria must be met for this option to take effect: 


e® The InfoGuard security subsystem must be activated on the system. 
@ The CLASS system option must have a value other than S2. 


The SECOPT (Security Options) system command controls the CLASS option. To 
use this command, a user must have security administrator status. For information 
on the SECOPT command and the CLASS option, see the A Series Security 
Administration Guide. 


SECURITYLABELS is a Boolean attribute. When it has a value of TRUE, the values 
of the following attributes are maintained in the tape label: SECURITYTYPE, 
SECURITYUSE, SECURITYGUARD, and FAMILYOWNER. 


You control the setting of the SECURITYLABELS attribute with the WFL VOLUME 
statement. See “Tape Management Enhancements in WFL” in Section 3. 


For additional information on the SECURITYLABELS volume attribute, see “Security 
Enhancements,” also in Section 3. 
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Using the ANSI87 Tape Label Format 


A Series systems can read and write tapes in ANSI X3.27 1987 (ANSI87) format as 
well as in ANSI X3.27 1969 (ANSI69) and other tape formats. Appendix B, “Standard 
Tape Formats,” illustrates the standard tape label formats supported by the A Series 
software. 


You can define. which label format is to be used when a tape is first opened for output. 
The format used for the first file on the tape defines the format for the entire volume 
set. After a file has been written to the tape, the system ignores any label-formatting 
specifications supplied by the user. 


The following tools enable you to control how a tape label is formatted: 


e LABELFORMAT system option 
e LABELFORMAT task attribute 
The default value of the LABELFORMAT system option is ANSI69. If no value 


is defined for the LABELFORMAT task attribute, the system uses the current 
LABELFORMAT system option value as the default task attribute value. 


See “Task Attributes” and “Security Enhancements,” both in Section 3, for details on 
these tools. 


Notes: 


@ Ifthe SECURITYLABELS volume attribute is TRUE for a tape, 
the system uses the ANSI87 standard when writing to that tape. 
See “Security Enhancements” in Section 3 for information on 
the SECURITYLABELS volume attribute. 


e A Series software at the Mark 3.9.1 or earlier release level is 
incapable of reading tapes written in ANSI87 format. 
Controlling Tape Label Formats with System Commands 


An operator can use the SYSOPS (System Options) system command to control the 
setting of the LABELFORMAT system option as follows: 


SYSOPS LABELFORMAT = ANSI87DEFAULT 
Including this form of the option in a SYSOPS command specifies that all subsequently 
written tape labels are to be written in ANSI87 format. If the value of the 
LABELFORMAT option is ANSI69 (the default value of the option), the system writes 
tape labels in ANSI69 format. 
All options set with the SYSOPS command retain their values across halt/loads. 


For additional information on the SYSOPS command, see Section 2, “System 
Commands.” 
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Controlling Tape Label Formats through Programs 


A programmer can use the LABELFORMAT task attribute to define a format to be 
used when he or she creates new tape volumes as follows: 


LABELFORMAT Task 

Attribute Value Format Used 

ANSI69 ANSI X3.27-1969 

ANSI87 ANSI X3.27-1987 

UNSPECIFIED Format defined by the LABELFORMAT system option 


You can use this attribute either to override an earlier specification — made with the 
LABELFORMAT system option or a previous LABELFORMAT task attribute — or to 
unconditionally request a particular label format. 


For additional information on the LABELFORMAT task attribute, see Section 3, 
“Programming Considerations.” 


Ignoring Tape Expiration Dates 


Whenever it readies a tape in order to write data to it, the MCP reads the expiration 
date from the tape label. If the expiration date has passed, the MCP acts according 
to whether the system option TAPEEXPIRATION is currently TRUE or FALSE, as 
follows: 


TAPEEXPIRATION 


Option Setting Action Taken by MCP if Expiration Date Has Passed 
TRUE (default) Treats the tape as a scratch tape | 
FALSE Ignores the expiration date of the tape 


The MCP identifies a tape that is past its expiration date as a scratch tape only if it 

is write-enabled. The data on the tape is not actually purged; a tape that is past its 
expiration date can still be read if the tape is not write-enabled. On reel-to-reel 

tape drives, a tape is write-enabled if it has a write ring in place. A cartridge tape is 
write-enabled if its file protection mechanism is set to the unprotected position. You set 
a cartridge tape file protection mechanism in one of the following ways, depending on 
the type of cartridge you are using: 


e On 5078 cartridges, use your thumb to roll the small knurled knob on the side of 
the cartridge until the rounded, unmarked surface appears. 


e On Unisys HD600XTD or HD6150 or equivalent tape cartridges for quarter-inch 
cartridge tape drives, position the write-protect plug on the top so that the arrow 
points away from the embossed word SAFE. 


Consult the documentation for your cartridge drives for additional information. 
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An operator can use the SYSOPS (System Options) system command to control the 
setting of the TAPEEXPIRATION option as follows: 


e To request that the option be activated, include any of the following forms of the 
option in a SYSOPS command: 
— TAPEEXPIRATION + 
—- TAPEEXPIRATION ON 
—- TAPEEXPIRATION TRUE 


e To request that the option be deactivated —that is, returned to its default status 
(not active) —include any of the following forms of the option in a SYSOPS 
command: 


-— TAPEEXPIRATION — 
- TAPEEXPIRATION OFF 
- TAPEEXPIRATION FALSE 


The default value for the option is TRUE. 


See Section 2, “System Commands,” for additional information on the SYSOPS 
command. 


Note: A requested change.to the setting of this option does not take effect 
immediately; it goes into effect the next time the MCP reads the tape 
label. 


Using New System Log Entries and Enhanced Existing 
Log Entries 


The enhancements to the tape management software include new entry points to the 
system log (SUMLOG) and changes to existing log entries, as follows: 


e The File Open log entry (LOGOPENTYPE) has been enhanced to record whether 
the TAPEMANAGER library changed any file attributes of a tape file before the 
file was opened. This entry now records additional error message numbers. 


e The File Close log entry (LOGCLOSETYPE) now records additional error message 
numbers. 


e The SETSTATUS call entry (LOGSETSTAT) has been enhanced to store an 
additional SETSTATUS value. 


@ The Volume Status entries (LOGMAJVOL) have been enhanced in the following 
areas: 


— The new Minor Type 12 (Tape Volume Used) entry is issued when an existing 
tape volume is assigned to a program. 


— The new Minor Type 13 (Tape Volume Hold) entry is issued when a HOLD 
(Hold Unit for Operator Use) system command changes the HOLD status of a 
tape unit. ; 
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— The Minor Type 5 (Tape Volume NEWFILE) entry is now issued for all cases in 
which an unlabeled tape file or a labeled tape file with NEWFILE = TRUE is: 
assigned to a tape volume. 


- The HOLD status of the volume is now included. 


— Minor Type 3 (Tape Volume Purged) log entries now store the scratch pool 
name in EBCDIC characters. _ 


@ Anew log entry minor type—CLU Hardware Report (CLUHWREPORT) — records 
Cartridge Tape Library (CTL) hardware activity (for RoboHost A users only). 


e@ The new Major Type 26—Tape Library Entry (LOGMAJ_ MEDIALIB) —documents 
TAPESERVER library entries (for RoboHost A users only). 


For more information on these entries, see “Logging Enhancements” in Section 3. 
The new system log (SUMLOG) entries for RoboHost A users are described in the 
RoboHost A Operations, Installation, and Administration Guide. 


Implementing Customized Tape Management Systems 


A tape management system (TMS) is any appiceson that is designed to record or 
control the usage of tapes on a system. 


The A Series system provides enhanced operating system support for user-created 
TMSs. Your site can make use of these enhancements by following these guidelines: 


@ You must implement as part of your TMS asupport library with the function name 


‘TAPEMANAGER. _ 
@ You must provide certain exported procedures in the TAPEMANAGER library. 
Whenever certain tape accesses occur, the operating system calls procedures from the 


TAPEMANAGER library. The library can then respond to each request in any of the 
following ways: 


e Perform the requested action. 
@ Deny the request. 
@ Modify the request. 


@ Record the request. 
The TAPEMANAGER library is entirely optional. 
The following paragraphs provide introductory information on using these entry 


points for your installation. For details, see Section 5, “TAPEMANAGER Library 
Implementation.” 
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Calling Standard Exported Procedures 


The standard exported procedures of a TAPEMANAGER library are as follows: 


_ previously closed with retention. 


CHECK TAPE_ASSIGNMENT 


This procedure determines what happens when a process attempts to open a tape 
file that has not yet been assigned to a tape volume, and for which the UNITNO 
file attribute has not yet been assigned. The procedure also supplies or modifies file 
attribute values to further specify the desired tape. 


CHECK TAPE _UNIT_ASSIGNMENT 


This procedure determines what happens when a process attempts to open a 
new tape file that has not yet been assigned to a tape volume, and for which the 
UNITNO file attribute has been assigned to a tape unit number. 


CHECK TAPE PURGE 
This procedure determines whether to allow or deny a request to purge a tape. 
CHECK TAPE REOPEN 


This procedure determines whether to allow or deny a request to reopen a tape file 


CONTROL_INTERFACE 


This procedure determines whether to allow or deny a request to initialize, 
terminate, or communicate with the TAPEMANAGER library. 


PROGRAM _INTERFACE 
The purpose of this procedure is defined by the library implementation. 


Controlling Tape Usage 


Following are examples of the types of control a TMS can exert over tape usage: 


Denying a process the right to open a given tape file 
Modifying the attributes of a tape file before the file open operation completes 


Denying a process, or an operator, the right to purge a given tape volume 


Installing a TAPEMANAGER Library 


See “Operations Interface to the TAPEMANAGER Library” in Section 5 for a 
discussion of the steps involved in installing, terminating, and inspecting the status of 
a TAPEMANAGER library. 
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Section 2 
System Commands 


Computer operators need to be aware of one new system command and changes 
to several existing system commands to effectively use the new tape management 
operation features. 


The HOLD (Hold Unit for Operator Use) command is new. 


The following commands have been modified to support new tape management 
features: 


e MODE (Unit Mode) 

e OL (Display Label and Paths) 

e OP (Options) 

e OU (Output Unit) 

e PER (Peripheral Status) 

e PG (Purge) and PGL (Purge and Lock) 

e SEND (Send Message) 

e SN (Serial Number) and SNL (Serial Number Lock) 
e@ SYSOPS (System Options) 


Note: The information in this section is based on the A Series System 
Commands Operations Reference Manual. 
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HOLD (Hold Unit for Operator Use) 


2-2 


The HOLD command either prevents the system from assigning files to a unit or allows 
the system to assign files to a unit that was previously the object of a HOLD command. 


The HOLD command is valid only for magnetic tape units. 


Syntax 


SS 
2 a 


Explanation 


A unit that is held aside for operator use cannot be assigned to any file, but the unit 
is still accessible to the system. Unit-related operator commands are not affected by 
the HOLD status of a unit. HOLD status is lost if the unit is the subject of a FREE 
command. Because the unit cannot be assigned to any command. Because the unit 
cannot be assigned to any file, an attempt to assign it by using an IL, UL, or OU 
command is not effective. 


Examples 


HOLD MT 18 

MT 18 FILE ASSIGNMENT HOLD IN EFFECT 
PER MT 

1@ SCRATCH (HOLD) 
HOLD ~ MT 18 


MT 18 FILE ASSIGNMENT NOT IN EFFECT 


Considerations for Use 


If you want to acquire a tape unit and prevent file assignment so that you can examine 
a tape label, perform the following steps: 


1. Acquire the unit with the SAVE option by entering ACQUIRE MT <unit 
number>: SAVE. 
Enter the HOLD command to prevent the system from assigning files to the unit. 


Enter the RY command so that the system can read the tape label. command so 
that the system can read the tape label. 


4. Enter the PER MT command so that you can read the name, status and serial 
number of the tape. 


8600 0940-000 


HOLD (Hold Unit for Operator Use) (cont.) 


Because the command TDIR <unit number> initiates the FILEDATA utility, which 
tries to open the tape on the specified unit, you cannot use that command on a tape 
drive for which you entered a HOLD command. 
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MODE (Unit Mode) 


The MODE (Unit Mode) command tells the system what you want the write-enable 
status of a unit to be. This command also changes the AUTOUNLOAD status. 


Syntax 
— MODE 
> DK <unit number 10 

DT - IN 

MT OUT 

PK 


<jiopartner specifications 


HC —<unit number 10 
IN 
OUT 
CLOSED 


MT —<unit number>— AUTOUNLOAD a es ON 
OFF 


<iopartner specifications > 


e. 
ge are lua fib indexs == 
: eo eae i Be i paces = : 


The hubindex is an integer in the range 0 through 15. 


Explanation 


MODE DK <unit number> !0 
MODE DT <unit number> 10 
MODE MT <unit number> [0 
MODE PK <unit number> [0 


Allow the device to revert to normal operation. 


MODE DK <unit number> IN 
MODE DT <unit number> IN 
MODE MT <unit number> IN 
MODE PK <unit number> IN 


Prevent new files from being created on the specified unit. This prohibition extends 

to new RESERVEDISK and BADDISK files, so that the RESERVE and XD functions 
are effectively blocked. These commands also prevent the allocation of new file areas 
to existing files, and file removal through the WFL command REMOVE A/B, C/= 
FROM D. However, user programs can still write to existing file areas, and can remove 
individual files through the CLOSE with PURGE command. 
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MODE DK <unit number> OUT 
MODE DT <unit number> OUT 
MODE MT <unit number> OUT 
MODE PK <unit number> OUT 


Allow the device to revert to normal operation. 


MODE HC <unit number> 10 


Allows the specified host control (HC) unit to be opened for input/output (I/O) use. It is 
valid only for HC-2 units (DLP-based I/O). 


MODE HC <unit number> IN 


Allows the specified HC unit to be opened for input (read operations) only. 


MODE HC <unit number> OUT 


Allows the specified HC unit to be opened for output (write operations) only. 


MODE HC <unit number> CLOSED 


Disallows HCFILE use of the specified HC unit. BNA Version 1 can use HC units that 
are closed, changing the mode of use as needed. 


MODE MT <unit number> AUTOUNLOAD ON 


Instructs the MCP to unload a tape on the device when the unit is closed and released 
or when the MCP performs a reel switch from the unit. 


MODE MT <unit number> AUTOUNLOAD OFF 


Instructs the MCP to unload a tape on the device only when specifically directed by a 
programmatic close or by the RW (Rewind) system command. 


WRITEPARTNER = <hubindex> 
WP = <hubindex> 


Cause all HCFILE write operations on the specified HC unit to be directed to the 
specified hubindex. 


READPARTNER = <hubindex> 
RP = <hubindex> 


Cause HCFILE read operations from the specified HC unit to expect input only from 
the hubindex. 
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— WRITEPARTNER 

— WP 

— READPARTNER 

-RP 

Remove WRITEPARTNER or READPARTNER specifications from the specified HC 
unit. 


Examples 


MODE HC 896 OUT 
HC@96 MODE IS OUT 
MODE MT 48 AUTOUNLOAD OFF 


MT 48 MODE IS AUTOUNLOAD OFF 


Considerations for Use 


Lf ousiied to HC units, the MODE command controls the direction of I/O as well as 
specifying partner HC units to which I/O is permitted. 


Direction can be specified only for a closed HC; this is the default state of an HC unit 
when it is not being used by BNA Version 1. . 


The IOPARTNER specifications can be used only for labeled HC units. The minus 
sign (—) syntax removes an I/O partner restriction from a labeled HC unit and causes 
any related hubindex to be ignored. A null READPARTNER or WRITEPARTNER 
specification is indicated by a value of -1. 


The IO, IN, OUT, and CLOSED options apply to both unlabeled HC units (used by BNA 
Version 1) and labeled HC units (used by HCFILE operations). 


The effect of the AUTOUNLOAD MODE option on programmatic file closes is 
summarized in Table 2-1. 


Table 2-1. AUTOUNLOAD Option Effects 


Option Value Effect on File CLOSE Result 
CLOSE(F) Rewound/unloaded 


CLOSE(F, REWIND) ~ Just rewound 
CLOSE(F,REEL) Rewound/unloaded 
CLOSE(F, PURGE) Rewound/unloaded 


continued 
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Table 2-1. AUTOUNLOAD Option Effects (cont.) 


Option Value Effect on File CLOSE Result 


CLOSE(F,*) Position retained 
CLOSE(F,LOCK) Rewound/unloaded 
REWIND(F) — Just rewound 
FLOPEN:=FALSE Just rewound 
Block exit close Rewound/unloaded 
Implicit close on reel switch Rewound/unloaded 
OFF (default) CLOSE(F) Just rewound 
CLOSE(F,REWIND) Just rewound 
CLOSE(F,REEL) Just rewound 
CLOSE(F,PURGE) Just rewound 
CLOSE(F,*) Position retained 
CLOSE(F,LOCK) Rewound/unloaded 
REWIND(F) Just rewound 
FLOPEN:=FALSE Just rewound 


Block exit close Just rewound 


Implicit close on reel switch Just rewound 


The value of the AUTOUNLOAD option is preserved across a halt/load. A program 
can override the setting of the AUTOUNLOAD MODE by using the AUTOUNLOAD 
file attribute. You can interrogate the value of the AUTOUNLOAD mode by using the 
system command OL (Display Label and Paths). 
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OL (Display Label and Paths) 


The OL (Display Label and Paths) command displays the label and path information 
for peripheral devices. 


Syntax 
Ss 
— OL <device>—<unit number list 
<A 17 OL options 
- <A17 OL options> 
; a peas CTL —<device number list 
PORT —<port "number rey 
Explanation 


The OL <device> <unit number list> command displays the label and path 
information for the devices. Because of differences in the hardware, the path 
information displayed for an Entry and Medium System (EMS) is different from the 
information displayed for a host data unit (HDU) system or a resource management 
module (RMM) system. 


Most OL displays are divided into two parts: an upper area that contains information 
specific to the type of unit, and a lower area that describes the paths to the unit. 


On EMS systems, if the path to the unit is through an outboard host — for example, the 
network support processor (NSP) data link processor (DLP)—a HOSTDLP column | 
follows the PATHID column. The entries in the HOSTDLP column are the physical 
unit numbers of the controlling DLPs. 


If no firmware-level information exists, the FIRMWARE column i is omitted from the 
display. 


The open count of each pack is displayed provided the total time to compute the 
number of open files for all packs on a screen does not exceed 60 seconds. The 
remaining packs on the screen (including the pack being computed when the time limit 
was reached) do not have an open count displayed. This case is different from a pack 
without open files, which displays an open count of zero. 


The path information displayed varies depending on whether the system is an EMS or 
HDU system. 
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OL Displays for A 17 Systems 


The A 17 OL displays are explained in the following paragraphs. 


OL CTL <device number> 

Displays the inboard and outboard information for the control. 

The OL control display is divided into three parts: an upper area composed of one or 
more lines describing information specific to the control, an area describing the inboard 


paths, and an area describing the outboard devices. 


Inboard information usually consists of the ports that serve the control. The following 
information is displayed, describing ports inboard of a control: 


Inboard Port | Description 
PORT Gives the number of the port serving this control. 
HOSTNSP Gives the number of the NSP serving this line support 
processor (LSP). 
STATUS Describes the status of the port that serves the control. The 
following list shows the possible port status conditions: 
@ RESERVED 


The port is reserved for maintenance. 
@ OUT OF SERVICE 


The port is not available for use. 


@ INUSE 
The port has been chosen for all I/Os to the control. 
@ ONLINE 


The port is online. 


OL PORT <port number list> 

Displays the inboard and outboard information for the port. 

The OL port display is divided into two parts: an upper area composed of one or more 
lines describing information specific to the port, and a lower area describing the 


controls outboard of the port. 


The following information is provided for controls outboard of a port: 


Outboard Port Description 

CTL (Control) | Gives the device number of the control outboard of the port. 
TYPE Gives the type of the control. . 
STATUS Describes the status of the control. The possible control 


status conditions are listed under the STATUS heading for 
resource management module (RMM) systems later in this 
section. 


| continued 
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continued 
Outboard Port Description 
VIA PORT Lists all ports that can access the control. The names of 


ports not online are enclosed in parentheses. 


The path information displayed varies, according to whether 
the system is an entry and medium system (EMS), host data 
unit (HDU), or resource management module (RMM) 
system. 


OL Displays for EMS Systems 


The OL displays for EMS systems are explained in the following paragraphs. 


PATHID 


A number representing a unique path from a host to the peripheral. The path includes 
the DLP and controller of the unit, if a controller exists. 


HOST 


The unique host processor number where the path originates. A hyphen (-) in this 
column indicates that the path originates at a host DLP (NSP). 


1OP PORT 
The number of the input/output processor (IOP) port to which the base containing the 


DLP is attached. A hyphen (-) in this column indicates that the path originates at a 
host DLP. 


MIRRORS 

For a mirrored pack only. This line of information displays the number of offline 
members, the number of online members, the number of pending members, and the 
unit numbers of online and offline members. Pending members are those in the process 


of being created or being brought online. This line is omitted for packs that are not 
mirrored. ; 


LEM PORT 
A number representing the relative line expansion module (LEM) port the path 


traverses. When a path originates at a HOST DLP (NSP), the LEM PORT number 
refers to the LEM attached to the host DLP. 


REL DLP 


The relative DLP within the base. 
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BASEID 


Identifies the base in which the DLP of the unit resides. | 


FIRMWARE 

A number representing the firmware level of a path. If no path firmware was loaded, 
NOTLOADED is displayed in the firmware column for that path. If path firmware level 
does not apply to the unit, the entire column is omitted. For group-coded recording 
(GCR) DLPs, the information describes master electronics control (MEC) controlware. 


For NSP and LSP DLPs, the firmware level and firmware value are displayed on the 
top line. For all other DLPs, the DLP firmware level is described. 


CONTROLWARE 


For Host Transfer (HT) and HT-sequential DLPs, the value of the controlware level is 
shown for each path. It is displayed in both EBCDIC and hexadecimal characters. . 


HOST DLP. 
The physical unit number of the outboard host DLP in control of the unit. A hyphen 


appears in the IOP PORT column because the port is not part of the path, implying 
that this path originates at a host processor The column is omitted if it does not apply. 


CTLID 


The controller identification number (0 through F). It is valid only for HT-sequential 
DLPs; otherwise, it is omitted. 


EXCH 
The active exchange numbers (0, 1, or both). If 0, exchange 0 is available. If 1, 
exchange | is available. If the active exchange is both (0,1), exchange 0 and exchange 


1 are both available. Exchange numbers are valid only for HT-sequential DLPs; 
otherwise, the column is omitted. 


HOST ADAP 


The function level and revision level of the host adapter (function level, revision level). 
These values are valid only for SMD1 DLPs; otherwise, the column is omitted. 


FORMAT 


The function level and revision level of the formatter (function level, revision level). 
These values are valid only for SMD1 DLPs; otherwise, the column is omitted. 
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ATTR PROM 


The revision level of the current unit attribute PROM. This value is valid only for 


_SMD1 DLPs; otherwise, the column is omitted. 


AUTOUNLOAD 
For magnetic tapes only. AUTOUNLOAD indicates whether or not the MCP is to 
unload a tape on the device when the unit is released by a close operation or when the 


MCP performs a reel switch from the unit. This option can be overridden by the 
AUTOUNLOAD file attribute. 


BLOCKSIZE 


For magnetic tape only, a number representing the maximum blocksize (in bytes, not 
words) that can be handled by the unit. | . 


IN USE 


An asterisk (*) indicates the path is currently selected for I/O by the processor of the 
path. Ifa column entry is blank, the path is not in use. 


STATUS 


Describes the status of a unit through a path and the status of a path to a unit. The 
possible path status conditions are described in the following table. READY and NOT 
READY status values do not apply to data comm units. 


Status | Meaning 

READY The processor can determine that the unit is ready through the 
path. 

NOT READY ¢ The processor can determine that the unit is not ready through the 
path. 

ONLINE Unit status can be determined through the path. 

OFFLINE Unit status cannot be determined through the path. 

RESERVED The path is reserved for maintenance. 

MAINTENANCE The path is assigned to a maintenance task. 


OL Displays for HDU Systems 


The OL displays for HDU systems are explained in the following paragraphs. 


HOSTDLP 


The device number of the outboard host DLP in control of the unit. This column is 
omitted if it does not apply. 
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FIRMWARE 


Same as FIRMWARE for EMS systems. 


CONTROLWARE 


Same as CONTROLWARE for EMS systems. 


AUTOUNLOAD 


Same as AUTOUNLOAD for EMS systems. 


BLOCKSIZE 


Same as BLOCKSIZE for EMS systems. 


STATUS 


Same as STATUS for EMS systems, but another entry type, IN-USE, indicates the 
current path used by the LSP 


MIRRORS 


Same as MIRRORS for EMS systems. 


OL Display for Resource Management Module (RMM) Systems 


The following path information is provided in the OL display of a unit: | 


Path Information Meaning 

CTL Gives the device number of the control that services the 
unit. 

HOSTCTL Gives the device number of the inboard host control for the 


unit (for example, the device number of the NSP servicing 
the LSP). This column is omitted when it is not applicable. 


FIRMWARE Gives a number representing the firmware level of a path. If 
path firmware level does not apply to the unit, the column is 
omitted. For group-coded recording (GCR) controls, the 
information describes the task control unit (TCU) firmware. 
For NSP, LSP and DCDLP controls, the firmware level and 
firmware value are displayed on the top line. For all other 
controls, the control firmware is described. 


CONTROLWARE Lists EBCDIC characters representing the controlware level 
of the controller of the device. 


continued 
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continued 
Path Information Meaning 


STATUS 


Describes the status of the control serving the unit. The 
following list shows the possible control status conditions: 


@ FREED 
The control is not attached to the executing group. 
@ RES MAINT 
The control is reserved for offline maintenance. 
@ RESERVED 
The control is reserved for maintenance. 
@ HUNG 


‘The control has not completed an outstanding I/O in a 
reasonable amount of time for that device type and will 
not be used for further I/O operations. 


@ OUT OF SERVICE 

The control is not available for use. 
@ NO PATH 

There is no available path to this control. 
@ IN USE 


The control has been selected for 1/O operations to the 
unit. This state is only displayed for NSP paths to LSP 
units. 


@ ONLINE 


The control is online. 


Example 1 


The following display shows output from the OL command on EMS systems: 


OL MT28 


MT  28*P [990394] (3834) 6258 #1 1:8 <@8/99/91> AOSUPPORT/FILE1271 
CREATIONDATE: 98/99/91 EXPIRATION DATE: 99/98/91 
CREATION SITE 20363 
LABELKIND: LIBRARY MAINTENANCE 
AUTOUNLOAD ON 
PATHID HOST IOP LEM REL BASEID FIRMWARE BLOCKSIZE IN STATUS 
PORT PORT DLP USE 
G3 1 6 V4) 7 1/1/68 6119 393219 * READY 
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OL MT 48 


MT 48*P D [TOMHB2] 1626 SCRATCH POOL: TABLE (HOLD) 
AUTOUNLOAD OFF 
PATHID HOST IOP LEM REL BASEID FIRMWARE BLOCKSIZE IN STATUS 
PORT PORT DLP USE 
G1 1 g 1 GB 2/2/2 0181 Vs) READY 


OL DC119 


DC 118 NSP (BLOCKED, LEVEL: 9.71) (8611) [3] 
PATHID HOST IOP LEM REL BASEID IN STATUS 


PORT PORT DLP USE 
11 5 2 8 1 3/3/@ * ONLINE 
G3 3 3 ot 3/3/28 ONLINE 
G1 1 - 6 1 3/3/08 OFFLINE 


OL DC114 


DC 114 LSP (PROM), DL=1:@ (8611) [3] 
PATHID HOST IOP LEM REL  BASEID HOSTDLP IN STATUS 


PORT PORT DLP USE 
rt 5 2 V4) d 3/3/08 118 * ONLINE 
@3 3 s) V4) 1 3/3/B - ONLINE 
61 1 - V4 1 3/3/68 - OFFLINE 


OL DC112 


DC 112 NSP (BLOCKED, NOT LOADED) (8615) [3] 
PATHID HOST IOP LEM REL BASEID IN STATUS 
| PORT PORT DLP USE 

11 3 2 @ 1 3/3/8 ONLINE 


OL DC115 


DC 115 LSP (RAM56KB, LEVEL: 2:45, FIRMWARE: 56KBLSP), DL=1:8(8611) [3] 
PATHID HOST IOP LEM REL BASEID HOSTDLP IN STATUS 


PORT PORT DLP USE 
a 5 2 g 1 3/3/8 119 * ONLINE 
03 3 3 g 1 3/3/8 - ONLINE 


1 1 - M4 1 = =3/3/8 - OFFLINE 


OL DC118 


DC 118 LSP (PROM) (8615) [3] 
PATHID HOST IOP LEM REL  BASEID HOSTDLP IN STATUS 
PORT PORT DLP USE 
11 3 2 S 1 3/3/@ 112 OFFLINE 
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OL DC113 


DC 113 LSP (RAM, FIRMWARE: NOT-LOADED) (8615) 


[3] 


PATHID HOST IOP LEM REL BASEID HOSTDLP IN STATUS 


PORT PORT DLP 
at 3 Z: V4) 1 2/2/68 112 


OL PK44 


PK 44*B [287044] #1 MCPS (4) [1,2,3] 
CREATED ON: 91/18/98 AT 98:29:83 

B9387/287 (INTERLACED) 

CAPACITY: 1117545 SECTORS (281158190 BYTES) 


USE 
OFFLINE 


PATHID HOST IOP LEM REL BASEID CONTROLWARE IN STATUS 


PORT PORT DLP 


11 3 1 8 3  1/3/6 Qe[pscs 
Q7 2 ® @ 5 £6/2/@  Qefpscs 
3 1 B® @® 5 6/1/86  QE[D8Cs 
92 1 3. @ 6 5/1/68  QE[D8scs 


OL PK212 (for an HTS DLP) 


PK 212*B [207644] #1 PKNM (4) [1,2,3] 
CREATED ON: 92/12/98 AT 10:39:83 

B9387S/207 (SEQUENTIAL) 

CAPACITY: 1117545 SECTORS (281158190 BYTES) 


] 
] 
J 
] 


USE 

* READY 
NOT READY 
READY 
RESERVED 


PATHID HOST IOP LEM REL BASEID CONTROLWARE CNTRL EXCH IN STATUS 


‘PORT PORT DLP I 
11 3 1 @® 3 1/3/8 QE[D8C5] 
07 2 ® 8 5 6/2/68 QE[D8C5] 
83 1 @ @ 5 B/1/8 QE[Dscs] 
2 1 3 6 6 5/1/8 QE[D8c5] 


OL PK47 (for an SMD1 DLP) 


PK  47*B [207044] #1 PACKNAME (7) {[1,2,3] 
CREATED ON: 03/16/90 AT 10:45:65 
SMD/214 
CAPACITY: 339864 SECTORS (201158100 BYTES) 
PATHID HOST IOP LEM REL BASEID HOST FORMAT 
PORT PORT DLP ADAP 
11 3 1 8B 3 1/3/6 6.5 7.8 
2 2 G8 GB 5 B/2/6 1.2 4.5 


D 
8 


oO rPmn 


USE 
g * READY 
6,1 READY 
4) NOT READY 
1 * READY 


ATTR IN STATUS 


PROM USE 
7 * READY 
2 * READY 
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OL (Display Label and Paths) (cont.) 


The following display shows output from the OL command on A 12 and A 15 systems: 


OL MT57 


MT 57*P K[@3725 
CREATIONDATE: @1/ 
' CREATION SITE 5 


2] (8513) 1680 #1 1:8 <@1/10/91> SYSTEM2/FILEg28 


18/91 EXPIRATION DATE: 2/89/91 


LABELKIND: LIBRARY MAINTENANCE 


AUTOUNLOAD ON 


DLP FIRMWARE BLOCKSIZE STATUS 

1807 0118 393219 ONLINE 

1197 8119 3932198 ONLINE 
OL DC188 


DC 18 NSP (BLO 


CKED, LEVEL: 15.71) (8599) 


DLP FIRMWARE STATUS 
188 15.71 ONLINE 
OL DC112 


DC 112 LSP (PRO 


DLP HOSTDLP 
Ti2 188 
112 119 
112 111 
OL DCi22 


DC 122 LSP (PROM) 


DLP HOSTDLP 
122 188 
122 118 
122 111 

OL DC123 


DC 123 LSP (RAM, 
DLP HOSTDLP 


123 188 

123 118 

123 111 
OL PK46 


M), DL=1:1 (8599) 
STATUS 
IN USE 
ONLINE 
ONLINE 


, DL=3:8 (1428) 
STATUS 
ONLINE 
BROKEN 
IN USE 


FIRMWARE: SMACHINE, LEVEL: 1.1), DL=1:8 (8599) 
FIRMWARE STATUS 
81986181 IN USE 
81969101 BROKEN 
01900101 ONLINE 


PK  46*B [287046] #1 DOC (#) 


CREATED ON: 12/04 


/98 AT 14:59:84 


B9387/207 (INTERLACED) 


CAPACITY: 111754 


5 SECTORS (201158198 BYTES) 


DLP CONTROLWARE STATUS 
2085 | FREED 
2045 QG ONLINE 
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OL PK192 


PK 1@2*B [235192] #1 NI32 (9) 
CREATED ON: 91/09/98 AT 18:48:31 


BX385/235 
CAPACITY: 969145 SECTORS (174446198 BYTES) 
DLP CONTROLWARE STATUS 
2815 FREED 
2186 KC ONLINE 
Example 3 


The following display shows output from the OL command on an A 17 system: 


OL MT 82 


MT 82*P [JRH ] 1608 #1 1:8 <@1/18/91> JRHTAPE/FILEQOO 


CREATIONDATE: @1/18/91 EXPIRATION DATE: 92/99/91 
CREATION SITE 5 

LABELKIND: LIBRARY MAINTENANCE 

AUTOUNLOAD ON 


CTL FIRMWARE STATUS 

2657. 6118 ONLINE 

2157 RESERVED 
OL PK 164 


PK  164*C [287124:207051:149] #2 PMDB (24) 
CREATED ON: 95/85/98 AT 98:86:29 

B9387/207 (INTERLACED) 

CAPACITY: 1555590 SECTORS (279998000 BYTES) 


CTL CONTROLWARE STATUS 

2005 FREED 

2045 QG ONLINE 
OL DC 199 - 


DC 189 NSP (MULTI-~HOST-BLOCK, LEVEL: 10.71) (2292) 


CTL FIRMWARE STATUS 
129 19.71 ONLINE 
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OL DC 115 


DC 115 LSP (RAM, FIRMWARE: SMACHINE, LEVEL: 1.1) (2292) 


CTL HOSTNSP FIRMWARE STATUS 

115 188 1.1 ONLINE 

115 109 see IN USE 

115 118 1.1 RESERVED 
OL HC 33 

HC 33 (8232) BNA [10] 


HUBNUMBER = 5,  HUBINDEX = 87 
HCFILES HUBINDEX RESTRICTIONS: 
READPARTNER = NONE, WRITEPARTNER = NONE 


CTL FIRMWARE STATUS 
33 8495 ONLINE 
OL PORT 12 


PORT 12 [ERL=@9.@,SLL=09.2995,SLL=@,FEATURES=8, (ALL HEX), 18/30/91] 


CTL TYPE STATUS VIA PORT 

321 HTS1 ONLINE 12, (14) 

52 HC2 RESERVED 12, (14) 

189 NSP4 OUT OF SERVICE 12,(14) 
OL PORT 3 


PORT 3 [ERL=89.8,SLL=09.2880,SLL=@,FEATURES=@ (ALL HEX), 10/10/91] 


CTL TYPE STATUS VIA PORT 
322 HTS1 FREED 133 
198 NSP3 IN USE 1,3 
2031 <TP2 . ONLINE 1,3 
881 MT2 OUT OF SERVICE 1,3 
OL CTL 322 


CTL 322: HTS1 <ONLINE> [Ua] 

PORT STATUS 

1 IN USE 

3 ONLINE 

OUTBOARD: 32,33,34,35, (36) , (37), (38), (39) 


OL. CTL 199 


CTL 109: NSP4 [19.71] 
PORT STATUS 

12 IN USE 

14 RESERVED 
OUTBOARD: 189 
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OL CTL 115 


CTL 115: LSP2 <ONLINE> [SMACHINE, 1.1] (2292) 
HOSTNSP STATUS 


188 ONLINE 

109 IN USE 

11¢ RESERVED 
OL CTL 33 


CTL 33: HC2 (8232) [10] 
HUBNUMBER = 5, HUBINDEX = 97 
_ PORT STATUS 

5 IN USE 

OUTBOARD: 33 
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OP (Options) 


The OP (Options) command displays, sets, or resets run-time operating system options 


that affect various system operations. 


Syntax 


— OP 
+ <option list 


<option list> 


‘ 


<option 


The available run-time operating system options are the following: 


_ Option 


8600 0940-000 


oOo ON A oO BP WD 


NM PP MP NYO KF BB RP BY RP BP HY RP YS YE 
Wo nNeY CO oO WON AD Oo BP W NY YF CO 


Meaning 

OPEN 
TERMINATE 
NOCHECK 
LPBDONLY 
AUTORM 
DIAGNOSTICS 
CDONLY 
AUTORECOVERY 
DUPSUPERVISOR 
DUPINTRINSICS 
TRANSWARNINGS 
AUTODC 
NODUMP 
CPBDONLY 
AUTORUNNING 
CRUNCH 
BACKUPBYJOBNR 
PDTODISK 
NOFETCH 
RESOURCECHECK 
Not in use. 
DIRDEBUG 
CATALOGING 


Option 
24 


25 


26 
27 
28 
29 
30 
31 
32 
33 
34 
35 
36 
37 
38 
39 
40 
4l 
42 
43 
44 
45 
46 
47 


Meaning 
OKTIMEANDDATE 
Not in use. 
LOGPOSITIONING 
SERIALNUMBER 
ARCHIVING 

Not in use. 
LOCKTRACE 
IORANGECHECK 
Not in use. 
KEYEDIOI 
MIRRORING 
DIAGNOSTICDUMP 
AUDIT 
FILESATURATION 
EOTSTATISTICS 
PATHBALANCING 
NETRECOVERY 
LOGIOERRORSNEW 
ISCDEBUG 
IODIAGNOSTICS 
PORTDEBUG 
USECATDEFAULT 
CATTEST 
MCPTEST 
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Explanation 


Following are descriptions of the OP command options: 


OP 


Displays all options and their respective states. 


OP+ 


Displays all options that are set. 


OP+ <option list> 


Sets all options in the option list. 


oP- 


Displays all options that are reset. 


oP- <option list> 


Resets all options in the option list. 


OP <option list> 


Displays the options in the option list and their respective states. 


<number> 


Identifies the option desired. (Do not confuse the run-time operating system options 
with the option word assigned to each job.) The number is between | and 47; however, 
some values are not used. The number of each option is listed with the following 
descriptions. 


OPEN (option 1) 


pe 


If this option is set, a file-open message is displayed for each task whenever the task 
opens a file. 


TERMINATE (option 2) 
If this option is set, abnormal task terminations are processed normally. If the option is 


reset, abnormal terminations or other various error conditions result in a full memory 
dump. 
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NOCHECK (option 3) 


If this option is set, memory dumps under FORGETCHECK conditions are inhibited. 
These dumps are automatic if the option is reset. 


LPBDONLY (option 4) 


If this option is set, all printer output files are assigned to a printer backup disk unless 
the PRINTDISPOSITION file attribute for the file has a value of DIRECT. (The printer 
backup disk is determined by the SB and DL BACKUP specifications.) These files can 
then be printed by the Print System, the SYSTEM/BACKUP utility, or the Work Flow 
Language (WFL) PRINT statement. 


AUTORM (option 5) 


If this option is set, the system automatically removes the old disk file when a 
duplicate-file condition occurs. If the option is reset, an RM (Remove) or OF (Optional 
File) command is required when such a condition occurs. 


DIAGNOSTICS (option 6) 


If this option is set, an RSVP request (for example, “RF DEGRADATION”) is displayed 
at the console any time the reliability of a hardware unit is degraded by a set amount. 


CDONLY (option 7) 


With this option set, any job opening a card input file that is not internal to the job is 
discontinued. Also, no card reader can be labeled. 


AUTORECOVERY (option 8) 


If this option is set, a halt/load is attempted after all system-fatal memory dumps 
(except dumps caused by a suspended processor). After the halt/load, DCPs or NSPs 
that were running before the halt/load are reinitialized and the autobackup number is 
restored to the value it had before the halt. 


If this option is reset, the AUTORECOVERY operations do not occur after a halt/load. 
Furthermore, the mix limit of all queues is set to 0 (zero) so that no jobs are 
automatically restarted. 


DUPSUPERVISOR (option 9) 


- Ifa code file titled <file title> is designated as the supervisor program and this option is 
set, at halt/load time the system executes a code file titled <file name>/FMLYINXnnn. 
If this option is reset, the system executes the designated supervisor program. For 
more information about the supervisor program, refer to the description of the CS 
(Change Supervisor) command earlier in this section. | 
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DUPINTRINSICS (option 10) 


If a file titled <file title> is designated as the intrinsics file and this option is set, then 
at halt/load time the system uses the code file titled <filename>/FMLYINXnnn as the 
intrinsics file. If the option is reset, the code file <file title> is used as the intrinsics file 
at halt/load time. For more information on the intrinsics file, refer to the description of 
the SI (System Intrinsics) command later in this section. 


TRANSWARNINGS (option 11) 


If this option is set and a program is given translation warnings, then the translation 
warnings are displayed and the code file is marked as having been given translation 
warnings. (Translation warnings are issued when a file is opened and there is a risk of 
invalid data access and/or data corruption.) 


If the option is reset, the translation warning mechanism is inactive. By default, the 


TRANSWARNINGS option is reset. For more information about translation, refer to 
the A Series I/O Subsystem Programming Guide. | 


AUTODC (option 12) 


If this option is set, data comm is automatically initiated if it is not running when an 


MCS performs a DCWRITE operation. 


The AUTODC option works as documented provided a station is defined in the 
SYSTEM/DATACOMINFO file as belonging to an MCS. 


NODUMP (option 13) 


If this option is set, the system does not try to take memory dumps. Potential nonfatal 
dumps are denoted by a display at the supervisory console and logged. The source of a 
fatal dump is listed in a system display at halt/load time. If the option is reset, dumps 

are taken in the normal fashion. 


CPBDONLY (option 14) 


If this option is set, all card punch files are assigned to a punch backup disk. (The 
punch backup disk is determined by the SB and DL BACKUP specifications.) These 
files can be punched by the Print System, the SYSTEM/BACKUP utility, or the Work 
Flow Language (WFL) PRINT statement. 


AUTORUNNING (option 15) 

When this option is set, certain default actions are taken in response to some of the 
RSVP requests that can arise during initialization. For some of these default actions; 
instead of waiting for you to reply, the RSVP request and the pone system message 
(MSRMISC117) are displayed: 


‘OP AUTORUNNING' IS SET, REPLY <reply> ASSUMED 
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The reply indicates the default action selected by the system. 


AUTORUNNING also controls how operator intervention is handled during memory 
dumps. When the AUTORUNNING option is set, DUMPDISKMASTER always creates 
a dump file on disk. If the DL DPFILES specification is null, the default disk location is 
the halt/load family. 


The following default actions are taken by system initialization when the 
AUTORUNNING option is set: 


e Ifthe halt/load unit is not in the current configuration, the unit is acquired without 
an RSVP. 


e Ifthe OKTIMEANDDATE option is set, the RSVP is omitted. 


e Ifthe CATALOG family cannot be found and the site is not cataloging (the OP 
CATALOGING option is not set), the DL (Disk Location) specification defaults to 
the halt/load family. 


e Ifthe CATALOG family cannot be found and the site is cataloging (if the OP 
CATALOGING option is set), no default action is taken. 


e All family complements proceed without RSVPs. If FLATREADER discovers bad 
records in a directory, it rebuilds the directory. If a disk family with duplicated 
directories is being complemented and one or more of the disks with duplicate 
directories is missing, the family is readied for use without the missing directories. 
If a site uses cataloging and a family is found to be missing from the volume library, 
the RSVP is skipped with an assumed OF (Optional File) response. _ 


e Ifthe JOBDESC family cannot be found, the DL specification defaults to the 
halt/load family. 


The following default actions are taken by system. memory dumps when the 
AUTORUNNING option is set: 


1. Ifno disk dump files are specified, the dump is not taken. For more information, 
refer to the descriptions of the CM (Change MCP) and DN (Dump Name) 
commands in this section. 


2. Ifadump disk file exists and is not full, the memory dump is captured. When the 
DUMPDISKMASTER command is initiated after the dump completes, a check is 
made to determine the MARKLEVEL of the dump. If the MARKLEVEL is not 
equal to the currently running MCP a message is displayed and the dump file 
within the dump disk file is skipped, leaving the file intact. 


Note: When the AUTORUNNING option is set, operator intervention. is 
required when the disk dump file is full. 


CRUNCH (option 16) 
If this option is set, code files and backup disk files are automatically crunched when 


they are closed. All other files are crunched when the CRUNCH option is used with the 
CLOSE statement. 
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BACKUPBYJOBNR (option 17) 
If this option is set, print requests are selected for printing by job number. If this option 


is reset, print requests are selected for printing according to the criteria specified in the 
PS SELECTION command. 


PDTODISK (option 18) 


If this option is set, all program dumps are automatically sent out to disk. If this option 
is reset, all program dumps are automatically sent out to a printer. 


NOFETCH (option 19) 


If this option is set, you need not enter an OK (Reactivate) command to reactivate a 
WEL job containing a FETCH statement. 


RESOURCECHECK (option 20) 
If this option is set, resource limits established by queues are enforced (refer to the tape 
specification parameter of the MQ command, described earlier in this section). Before 


jobs are admitted into queues, the RESOURCE task attributes are checked to ensure 
they do not exceed the established limits. If the option is reset, the limits are ignored. 


NOSUMMARY (option 21) 


This option has been deimplemented. Use the PS DEFAULT JOBSUMMARY 
command. 


DIRDEBUG (option 22) 


Note: This option is intended for use by Unisys facilities only. 


CATALOGING (option 23) 


CATALOGING is tested during disk initialization after a halt/load. If this option is set, 
the CATALOGLEVEL attribute is initialized to CATALOGLEVELSET; if it is reset, 
CATALOGLEVEL is set to 0. A cataloging operating system is any operating system 
whose CATALOGLEVEL is greater than 0. The effect of CATALOGLEVEL is described 
in the A Series Disk Subsystem Administration and Operations Guide. 


Note: This option can be enabled or disabled during the 
OKTIMEANDDATE verification. If you enable or disable the option 


after system initialization is completed, the change does not take 
' place until a halt/load occurs. 


OKTIMEANDDATE (option 24) 


This option requires you to verify the system TIME and DATE values at halt/load time. 
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If the option is set, the current TIME and DATE settings are displayed on the ODT 
after a halt/load, and you must enter TIMEOK in response to the message “PLEASE 
VERIFY TIME AND DATE” to resume normal processing. To correct TIME or DATE 
before entering TIMEOK, use the DR (Date Reset) or TR (Time Reset) commands. 


Caution: 


lf you use disk mirroring at your site, a halt/load performed during the delay 
while the system waits for the response to the RSVP message causes the mirrors 
to lose their contents. 


LOGPOSITIONING (option 26) 


If this option is set, when a parity I/O error on a tape occurs, the system tries to recover 
from the error by repositioning the tape and retrying the I/O process. If an I/O error 
occurs during the repositioning of a tape, you can use the log records that are written 
to analyze why the recovery was not successful. 


SERIALNUMBER (option 27) 


If this option is set, files are not assigned to scratch tapes unless either the SERIALNO 
file attribute matches the serial number of the tape, the SCRATCHPOOL file attribute 
matches the scratch pool designation of the tape, or an OU (Output Unit) system 
command is used to direct the assignment to a particular scratch tape. For more 
information, refer to the OU command description later in this section. 


ARCHIVING (option 28) . 

This option enables the archiving function of the catalog subsystem. If this option is 
set and the catalog level of the system is greater than 0 (zero), an archive log is.created. 
The name of the archive log is ARCHIVELOG/<date>/<time>, where <date> and 


<time> are the creation date and creation time of the file, respectively. If the archive 
log cannot be set up, the system automatically resets the option. 


LOCKTRACE (option 30) 
Note: This option is intended for use by Unisys facilities only. 


IORANGECHECK (option 31) 
This option verifies that the disk address requested for an I/O is within the range of 


one of the areas of the file. For TORANGECHECK to have any effect, the cs aca 
option DIAGNOSTICS must be set when the system is being compiled. 
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_ KEYEDIOII (option 33) 


Setting this option ensures that all new files created with FILEORGANIZA- 

TION = VALUE (INDEXED), VALUE (INDEXEDNOTRESTRICTED), or VALUE. 
(KEYEDIOII) are linked to the SYSTEM/KEYEDIOTI library and are created as 
KEYEDIOII files. Existing files are correctly linked to either SYSTEM/KEYEDIO or 
SYSTEM/KEYEDIOII depending on how they were created. Therefore, you can read 
and update both KEYEDIO and KEYEDIOITI files, but all new files are KEYEDIOII. 


Resetting this option ensures that all new files created with FILEORGANIZA- 
TION = VALUE (INDEXED) or VALUE (INDEXEDNOTRESTRICTED) are linked 
to the SYSTEM/KEYEDIO library and are created as KEYEDIO files. Existing 
files are correctly linked to either SYSTEM/KEYEDIO or SYSTEM/KEYEDIOII 
depending on how they were created. KEYEDIOTI files are created only when the 
FILEORGANIZATION is explicitly set to VALUE (KEYEDIOII). Otherwise, a 
KEYEDIO file is created. 


MIRRORING (option 34) 
This option allows disk mirroring to occur after the next halt/load. At that time, a 
mirror information table (MIT) and other structures needed for disk mirroring are 


created. 


Mirrored sets are allowed to come online only if the MIRRORING option was set before 
the last halt/load, and it has remained set. 


The option can be changed, subject to the following conditions: 


e An OP+ MIRRORING command is ignored if mirroring is already in effect. | 


e An OP- MIRRORING command is rejected if any mirrored sets are currently _ 
present in the system. All mirrored sets must first either be closed or be reduced to 
single packs with the MIRROR RELEASE command. 


DIAGNOSTICDUMP (option 35) 
If set, this option enables certain other memory dump calls to be made for diagnostic 


purposes. Also, the system provides maximum diagnostic information when an 
exception condition occurs. 


AUDIT (option 36) 


Note: This option is intended for use by Unisys facilities only. 


FILESATURATION (option 37) 


If set, this option causes the following warning message to be issued whenever the 
system allocates the last row of a disk file: 


WARNING, ALLOCATING LAST ROW OF FILE <file name> 
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The preceding message is subject to the following restrictions: 


e It applies to “programmer” files, including ordinary data files, printer/punch 
backup files, and compiler code files. | 


e@ It does not apply to internal system files such as SYSTEM/SUMLOG or library 
maintenance files. 


@ It does not necessarily mean that the file is almost full. Some areas might have 
been skipped if the file was written randomly. 


For files whose FLEXIBLE attribute is set to TRUE, the message is issued only when 
row 1000 is allocated. Most files have the TRUE value for the FLEXIBLE attribute (it 
is the default value), and few files need 1000 areas. Therefore, the warning message 
seldom appears. 


EOTSTATISTICS (option 38) 


If this option is set, end-of-task (EOT) statistics for each task are displayed on the ODT 
in the following format: ; 


<mix number> EOT TIMES: ET=hhh:mm:ss.s PT=hhh:mm:ss.s I0=hhh:mm:ss.s 


In this display, hhh denotes the hours, mm denotes the minutes, and ss.s denotes the 
seconds (rounded to the nearest tenth). 


PATHBALANCING (option 39) 


This option, which enables dynamic path balancing, applies to EMS systems — with the 
exception of A 10 systems that use MCP (Path balancing is performed automatically on 
HDU systems and on A 10 systems that use MCP) 


Dynamic path balancing distributes pack I/Os more evenly across busy multiple-path 
disk pack subsystems. For tape units, the order in which data is transferred is crucial; 


therefore, the static path allocation technique is always used for tapes. 


Path business calculations and dynamic path balancing do not occur on single-path 
subsystems. 


NETRECOVERY (option 40) 
If this option is set, during halt/load processing the system determines the last state of 


the currently selected BNA. If the state was not running, BNA is not initiated. If BNA 
was running before the halt/load, BNA libraries and stacks are initiated. . 


LOGIOERRORSNEW (Option 41) 
If this option is set, all I/O errors are logged in the Maintenance MLIOEXCEPTION 


SUMLOG record. If this option is reset, MLI I/O errors continue to be logged in the 
Maintenance MLIOERRORHDP SUMLOG record. 
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Note: Ina future release this option will be removed and all I/O errors will 
automatically be logged in the Maintenance MLIOEXCEPTION 
SUMLOG record. 


ISCDEBUG (Option 42) 


Note: This option is intended for use by Unisys facilities only. 


IODIAGNOSTICS (option 43) 


Note: This option is intended for use by Unisys facilities only. 


PORTDEBUG (option 44) 
‘If this option is set on an operating system that was compiled with the compile-time 
option INTERNAL set (a diagnostic system), port debug trace information is written 


to the SYSTEM/SUMLOG file in BNA debug log records. You can examine this 
information by running LOGANALYZER. 


USECATDEFAULT (option 45) 
The value of this option has meaning only on an operating system that is 


running CATALOGING. If this option is set, the default value of the file attribute 
USECATALOG is TRUE. 


CATTEST (option 46) 


Note: This option is intended for use by Unisys facilities only. 


MCPTEST (option 47). 


Note: This option is intended for use by Unisys facilities only. 
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Example 1 


The following example shows the response to a simple OP command. Options that have 
an asterisk (*) next to them are set; all others are reset. 


OP 
----- OPTIONS -~---- 
1 OPEN 2* TERMINATE 3 NOCHECK 4*L_LPBDONLY 
5*AUTORM 6 DIAGNOSTICS 7 CDONLY 8*AUTORECOVERY 
9 DUPSUPERVISOR 1@ DUPINTRINSICS 11 TRANSWARNINGS 12*AUTODC 
13 NODUMP 14*CPBDONLY 15 AUTORUNNING 16*CRUNCH 
17 BACKUPBYJOBNR 18 PDTODISK 19*NOFETCH 20* RESOURCECHECK 
26*LOGPOSITIONING 22 DIRDEBUG 23*CATALOGING 24*OKTIMEANDDATE 
27*SERIALNUMBER 28 ARCHIVING 3@ LOCKTRACE 31 IORANGECHECK 
33 KEYEDIOII 34 MIRRORING 35 DIAGNOSTICDUMP 36 AUDIT 
37 FILESATURATION 38 EOTSTATISTICS 39 PATHBALANCING 4@ NETRECOVERY 
41 LOGIOERRORSNEW 42 ISCDEBUG 43 IODIAGNOSTICS 44 PORTDEBUG 
45 USECATDEFAULT 46*CATTEST 47 MCPTEST 
Example 2 


This example shows the display for a status query of option 1: 


OP 1 


1 OPEN RESET 


Example 3 


This example displays all the options that are reset: 


OP- 

----- RESET OPTIONS ----- 

1 OPEN 3 NOCHECK 

6 DIAGNOSTICS 7 CDONLY | 

9 DUPSUPERVISOR 18 DUPINTRINSICS 
13 NODUMP 17 BACKUPBYJOBNR 
22 DIRDEBUG 24 OKTIMEANDDATE 
31 IORANGECHECK 43 IODIAGNOSTICS 
46 CATTEST 47 MCPTEST 
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Example 4 


These commands set or reset particular options: 


OP+ 3 


3 NOCHECK SET 


OP- 3 


3 NOCHECK RESET . 


OP+ OPEN 
1 OPEN SET 
OP- OPEN 


1 OPEN RESET 
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OU (Output Unit) © 


The OU (Output Unit) command directs output from the specified task or tasks to a 
specified output device or to any available device of the specified type. 


Syntax 


<mix number>— OU — MT —<unit number 
<mix number list>— OU —— MT 


<mix number list>— OU PK 
DK 
cP 
LP 


Explanation 


<mix number> OU MT <unit number> 


Directs output from the task specified by the mix number to the specified tape unit, 
provided it is write-enabled and identified as SCRATCH. (This command overrides 
locked units.) This form of the command can override a request for a specific type of 
tape unit and can substitute any other type of unit, if no units of the requested type are 
available. The system ignores any substitute backup setting set by the SB (Substitute 
Backup) command. The OU MT command overrides any tape serial number, density 
specification, and SCRATCHPOOL specification that the program makes. To use this 
form of the command, the unit must be ready, write-enabled, and not marked with 
HOLD status. For more information on HOLD status, refer to the HOLD (Hold Unit 
for Operator Use) command earlier in this guide. 


<mix number list> OU MT 


Has no effect on nonbackup files. Causes the backup file opened by the specified task to 

_ be written to any available tape drive. If a substitute backup medium was established 
for tape by the SB (Substitute Backup) command, the output goes to the substitute 
medium instead. 


<mix number list> OU PK 


Has no effect on nonbackup files. Controls the destination for backup output files as © 
follows: 


e@ Ifthe file has a family name specified, the file is sent to the pack with that family 
name. 


e Ifa file has no family name specified, it is sent to PACK by default. If a substitute 
backup medium was established for PACK by the SB (Substitute Backup) 
command, output goes to the substitute medium instead. 


8600 0940-000 2-33 


OU (Output Unit) (cont) 


<mix number list> OU PK <unit number> 


Places the files on the specified disk pack unit. Only a native-mode, write-enabled base 
pack with the specified name can be designated. Any substitute backup setting set by 
the SB (Substitute Backup) command is ignored. 


<mix number list> OU DK 


Has no effect on nonbackup files. Controls the destination for backup output files as 
follows: 


e Ifthe file has a family name specified, the file is sent to the pack with that family 
name. Only a native-mode, write-enabled base pack with the specified name can be 
designated. 


e Ifa file has no family name specified, it is sent to DISK by default. If a substitute 
backup medium was established for DISK by the SB (Substitute Backup) command, 
output goes to the substitute medium instead. 


<mix number list> OU DK <unit number> 


Places the files on the memory disk unit identified by <unit number>. Any substitute 
backup setting set by the SB (Substitute Backup) command is ignored. 


<mix number list> OU CP 
<mix number list> OU CP <unit number> 


Direct the output files to a specific card punch unit if <unit number> is specified, or to 
any available card punch if <unit number> is omitted. 


<mix number list> OU LP 
<mix number list> OU LP <unit number> 


Direct the output files to a specific line printer if <unit number> is specified, or to any 
available line printer if <unit number> is omitted. 


<mix number list> OU SC 
<mix number list> OU SC <unit number> 


Direct the output files to a specific ODT if <unit number> is specified, or to any 
available ODT if <unit number> is omitted. 


2-34 8600 0940-000 


OU (Output Unit) (cont.) 


Example 

Several RSVP requests accept a response of OU. One such request is system message 
MSRFOUTS0: “<file name> REQUIRES <unit identifier>”. This message is 
generated when a task cannot locate a unit that matches the selection attributes of an 
output file. 

If the program requests a backup medium, backup information is appended to the 
message. If the program requests a particular tape serial number or density, the 
specified serial number or density is appended to the message. 

The operator can enter an OU response; for example: 


2121 OU MT 1 


If the OU response specifies an inappropriate device, an error message is displayed. 
Two possible messages are the following: 


DIRECT FILE CANNOT BACKUP 

NEED AN OUTPUT TAPE FOR OU MT 

The first message is generated because a direct file asking for a line printer or card 
punch cannot go to backup under any circumstances. Direct implies that the program 
can look at result descriptors and can set error maskout. Direct files must therefore 


deal with an actual target peripheral. 


In the second message, an OU MT response was unsuccessful because no suitable tape 
is available. 


Considerations for Use 


Other messages that accept an OU response are as follows: 


PK<unit number> <number> SECTORS REQUIRED 
CATALOG FAMILY MISSING (IL OR HL): <family name> 


<unit type> <unit number> TYPE DISAGREES WITH KIND, 
REQUIRES MT # <unit number> 


_ <device ID> UNABLE TO LOAD TRAIN, SELECT ANOTHER PRINTER 
<unit identifier> REQUIRES FORMID <form name> 
<unit identifier> MUST BE UNFORMED 


For installations that use the tape security subsystem, be aware of the following effects 
of the OU command: 
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@ You can use the OU MT command to assign to the program an output tape volume 
that is not listed in the tape volume directory. 


@ You cannot use OU MT command to override the familyowner specification of the 
tape security subsystem. 


For information about the tape security subsystem, refer to the TAPECHECK = 
AUTOMATIC option in the A Series Security Administration Guide. 


You can use the OU command to override a mismatch between the FORMID attribute 
of the file, if specified, and the form of a printer, if any. However, these commands 
cannot override the KIND attribute of the file. 


Any attempt to override the KIND attribute of the file generates the following message 
that indicates the devices expected by the OU command: 


OU REJECTED, REQUIRES <device list> 


The RSVP that requested the OU command is reissued. 
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The PER (Peripheral Status) command displays the status of peripheral units. 


Explanation 


PER 


Displays the status of all peripheral units. 


PER <device> 


Displays the status of all peripheral units of the specified device type. 


PER= 
PER- 


Display the status of all peripheral units, including unlabeled and unready devices. 


PER <device> = 
PER <device>— 


Display the status of all peripheral units of the specified device type, including 
unlabeled and unready devices. 


If a pack on a given unit has a status of U (unavailable for normal use), any of the 
following messages might be displayed: 


Message Meaning 


UNLABELED indicates that no label information exists in memory for the pack. 
Either the pack has not been initialized, ora CLOSE PKnn 
command has been entered for the unit, or the directory 
complementor failed while reading the directories on the pack. 


UNINITIALIZED Indicates that the pack has not been reconfigured with an RC 
(Reconfigure Disk) command. 


BLASTED Indicates that the pack was cleared and must be closed and readied 
before being used. 


Any of the following Indicates that the status of a pack is U (unavailable for normal use). 
messages: LABEL 

ERROR, SCRATCH, 

NOT READY, SAVED, 

or DUP SERIAL. 
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Example 1 

PER MT 

sepoouicletesesecc ped teecesetex Mi -STALUS aes eeesscee Use eeeesscccous les 
48*P\ [TOMHB2] 6250 SC RA TCH POOL: HALL (HOLD) 
5Q*P [111222] 1686 SCRATCH 

51*P [911118] (887) 6258 #1 1:0 <11/18/91> DTAPE/FILE@@1 
52*P [@00801] 6258 #1 1:@ EXAM (HOLD) 

Doar [IADDIE] 6258 SCRATCH POOL: CUE 

115*H [@98116] 38008 #1 1:8 <3/87/90> MASTER/TEST 

116 H SAVED 

I31*P\ [980065] (2321) 1600 #1 1:3 <6/12/98> CAN/FILE@OO 


132*P R[999999] 16@@ #1 1:1 <11/13/9@> DANGEROUS/FILEG@2 

133*P D [@@0002] 1600 #1 1:1 <12/84/9> A/B 

134*P [990933] 1600 #1 1:1 <1@/17/91> A/B 

164 P [@12345] 1600 #1 1:1 BLOCKSIZE 669@@ TOO LARGE, CAN'T READ 


The preceding display shows the serial number in brackets ([]), the tape density, the 
ree] number, the cycle number and version number separated by a colon (:), the 
creation date in angle brackets(<>), and the title of the tape. If the tape is in use, the 
mix number is also displayed in parentheses following the serial number. If the tape is 
in ascratch pool, the pool name follows the colon after the words SC RA T CH POOL. 
If the tape is being held, the designation HOLD appears in parentheses. 


The following table describes the displayed fields and their meanings: 


Field Description 

1 Shows the unit number. 

2 Contains an asterisk (*) if the tape is write-enabled. 

3 The number 8 indicates an 8 millimeter cartridge tape. The number 9 indicates a 


9-track nonreturn-to-zero (NRZ) tape. The letter P indicates a 9-track 
phase-encoded (PE) or group-coded recording (GCR) tape. The letter H indicates a 
half-inch cartridge tape. The letter Q indicates a quarter-inch cartridge tape. 


4 A backslash (\) or an x designates a tape entered in a volume library. 

5 The letter D indicates that the mounted volume is listed in the Volume Directory. 

6 The letter R indicates that the unit has had security restrictions imposed on it. For 
more information, see the description of the RESTRICT (Restrict Unit or Volume) 
command. 


If the label of the tape mounted on a tape drive indicates that the block size of the file 
exceeds the maximum block size that the unit can handle, the following message is 
displayed in place of the title. In the message that follows, <I> is the block size in the 
label: 


BLOCKSIZE <I> TOO LARGE, CAN'T READ 
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Note If SYSOPS TAPEEXPIRATION = ON and an expired tape is 
mounted with a write ring, the display shows the tape as a SCRATCH 
tape. If SYSOPS TAPEEXPIRATION = ON and an expired tape is 
mounted without a write ring, the display shows the tape as a labeled 
tape. 


Example 2 


For mirrored packs, the PER PK command displays only one member of each mirrored 
set, but the PER PK= command displays all members. 


PER PK 
bees stewed eatwedeeecauesce PK STATUS) stemete eter aoe teo te eeac se 
96*B [920097] (MCP) #1 DAMISDB (1) 

97*Bx [9@0096] #1 SSDMASTER (11) 

98*C [820098 : 020097 :096] #2 DAMISDB (8) 

99 U CLOSED 

128*U UNINITIALIZED 

193*B [999099] #1 TRIAL (1) 


112 BR [082112] #1 HAZARD (8) 


Each pack entry in the PER PK display includes the unit number, type of pack, and 
label information (family name and serial number). The display also indicates whether 
the pack is currently being used by an MCP procesure (for example, READPACKLBL). 
The following fields are displayed: 


Field Description 
1 The unit number. 
2 An asterisk (*) if the write-enable switch is on and the MODE is IO or OUT; a blank if 


the write-enable switch is off or the MODE is IN. 
3 The pack type. The following codes are displayed: 

@  B: Native-mode base pack 

@ |: Interchange-mode pack 

@ C: Native-mode continuation pack 


@ U:A pack that is not available for normal use 


4 On the ODT in this example, the character displayed to denote volume library entries 
is an x. 
5 The letter R if security restrictions were imposed on the pack. For more information, 


see the description of the RESTRICT command. 


6 The letter M if the pack is mirrored. If a mirrored set is in the process of coming 
online but is waiting for another previously online member, it is considered a partial 
mirrored set. These packs are marked with a lowercase 77 instead of an uppercase 
M. 


continued 
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continued 
Field Description 
7 The disk pack family description for native-mode packs or the disk pack serial 
number in brackets ([]). For native mode packs, the family description consists of 
the following three items, with colons (:) separating them: 

@ The serial number of the disk pack on this unit. 

@ The serial number of the pack used to identify the family; that is, the first pack 
created in the family. Note that this will not necessarily be the base pack if the 
family has duplicated directories. 

@ The unit number of the current base pack for this family. If item 3 refers to the 
unit itself, then it is omitted. If item 3 refers to the unit itself and item 2 is the 
serial number of the pack on this unit, then items 2 and 3 are omitted. 

The family index number, from 1 through 255. 

9 The family name. 
10 The count (in parentheses) of files open or in use on the disks. 
Example 3 


This example shows a display for a memory disk on an A 3 system: 


See see eseetaaeceeeeeseuenes ee DY STATUS +Stoee ete ope saecensess 


255*MD (READY:8) [00255] #1 MEMDISK (8) 


Example 4 


This example shows the response to a PER DC command. DC designates a 
data-comm-type device: an NSP LSP or DCDLP. 


PER DC 


107 NSP (BLOCKED, NOT LOADED) 

198 NSP (MULTI-HOST-BLOCK, LEVEL: 19.7) (1439) 

199 NSP (DC-DLP, LEVEL 25.8) (8915) 

119 NSP (MULTI-HOST-BLOCK, LEVEL: 19.78) (1429) 

111 NSP (BLOCKED, LEVEL: 15.78) (1428) 

122 LSP (PROM), DL=4:9 (1428) 

123 LSP (RAM, FIRMWARE: SMACHINE, LEVEL: 1.1), DL=1:@ (1439) 
124 LSP (RAM, FIRMWARE: BDLC, LEVEL: 1.54), DL=4:2 (1428) 

125 LSP (RAMS6KB, FIRMWARE: 56KBLSP, LEVEL: 2.18), DL=3:8(1429) 
126 LSP (RAM, FIRMWARE: NATIVE, LEVEL: 1.35), DL=4:1(1428) 

127 LSP (RAM, FIRMWARE: NOT LOADED) 

128 LSP (RAM, FIRMWARE: POLLSELECT, LEVEL: 1.88), DL=1:1(1438) 
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For an NSP or a DCDLP the first entry describes the NSP type, and the second entry 
describes its firmware level (the first number describes the patch level, and the second 
number describes the PROM level). If no firmware has been loaded, “NOT LOADED” 
is displayed as the firmware level. If the firmware level is zero, it is not displayed. 


For an LSP the first entry describes its type, the second entry indicates its firmware 
type, and the third entry indicates its firmware level (the patch level and PROM level). 
If no firmware has been loaded, the message “FIRMWARE: NOT LOADED” appears in 
the firmware type entry, and the firmware level is 0 (zero). The level is not displayed 
for LSPs that are of the type PROM. 


Example 5 


The open count of each pack is displayed in parentheses if the total time to compute 
the number of open files for all packs on a page does not exceed 5 seconds. If the 
computation time exceeds 5 seconds, the field is not displayed. (A pack without open 
files, on the other hand, displays an open count of zero.) 


This example shows the display in which the open count for some units is not computed 
because the computation time exceeded 5 seconds: 


150*B [207158] #1 DISK (27) 

151*B [206151] #1 TESTPACK (8) 

*** QPEN COUNT NOT COMPUTED FOR REMAINING UNITS (USE OL FOR COUNT) *** 
153*B [207153] #1 PACK 

162*B [207162] #1 DBUNIT 


Example 6 


This example shows the display for three ODTs. The first two are not restricted; the 
third is restricted: 


PER SC 
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Example 7 


This example shows displays for line printers attached to the system: 


PER LP 


Hf oreecencsdeetuetenetaee itu ct DEY STA USMetecee Sosa ose ee ee 


(227) 
(8832) 
(6969) 


(MCP) 


SCRATCH _ EBCDICIE 
SERVER/LP5/"R#8476"/"J#3284" ASCII86 
*SYSTEM/PRINT COPY (UNKNOWN TRAINID) 


FORMED : MEDFORM SERVER/LP8/"R#8476"/"J#3299" 
FORMED : "MEDICAL FORM # 2" 


SAVED (DEFAULT DESTINATION) 
NOT READY EBCDIC96 (DEFAULT DESTINATION) 
RESERVED 


Each entry in the PER LP display includes the external unit number and the status of 
the printer. The following fields are displayed: 


Field 


t 
Z 
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Description 
Indicates the external unit number of the printer. 


Optional field that shows special |/O status enclosed in angle brackets 
(<>). 


If the printer is in use, this optional field indicates the system or the mix 
number of the stack using the printer. 


If the printer is not in use, this optional field indicates that the printer is 
configured for special forms with the designation FORMED, followed by the 
form identifier. 


Indicates the status of the printer or who is controlling the printer. Terms 
used in this field include TO BE SAVED, SAVED, LOCKED, SC RATCH, 
NOT READY, the file title, and the name of the print server if a file is 
printing. 


If the printer is not in use, this optional field contains either the name of the 
TRAINID character or the statement (UNKNOWN TRAINID). 
TRAINID is a file attribute that refers to the character set that is available to 
the printer. 


If the printer is not in use, this field is blank. 


If a printer that is in use is ABED, this field contains the name of the 


- TRAINID or the words (UNKNOWN TRAINID). If a printer that is in 


use is FORMED, then the field contains the name of the form. 
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PG (Purge) and PGL (Purge and Lock) 


The PG (Purge) command purges tape, disk pack, or host control units. The pack and 
tape units must be ready and not in use, and the units must be write enabled. Host 
control units can be purged when they are not ready. 


The PG command is not valid for use with online mirrored packs. Before using the PG 
command, you must release the pack with the MIRROR RELEASE command. The PG 
command is valid for closed mirrored packs provided you respond OK to the RSVP 
request that appears. 


The PG command optionally specifies the recording density for tapes and assigns tapes 
to scratch pools. 


The PGL (Purge and Lock) command purges and locks tape, disk pack, or host control 
units. You cannot use them until you ready the unit with the RY (Ready) command. 


Syntax 


PG MT —<unit number list 
L. pet /1\— (<density>) 
/1\—<scratch pool 


OLDNAME a ei aa name 


PK —<unit number 


HC ——<unit number 


<density> 


200 
556 
828 
1258 
1628 
6258 
11928 
38028 


<scratch pool> 


aa het Ae a NR i pool name>————__________—__| 


POOL 


<scratch pool name> . 


<letter 
Ledigit 


Be 1 
<underscore 


Explanation 
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PG MT <unit number list> 
Purges the volumes mounted on the tape units in the unit number list. The PG 
command requires that the tape is labeled and has a serial number; however, this serial 


number is not affected by the command. To assign serial numbers to unlabeled tapes, 
use the SN (Serial Number) command. 


(<density>) 

Specifies the recording density of the tape. If the density is specified, it applies to all 
tapes mounted on the units in the unit number list. If the density you specify is not 
valid for the unit, the system displays the following message: 

MT <unit number> INVALID DENSITY SPECIFIED 


In such a case, the tape density is not changed, but the system still purges the tape. 


PGL MT <unit number list> 
PGL MT <unit number list> ( <density> ) 


Has the same effect as the PG command except that it locks the tape units after 
purging them so that no job can automatically acquire them as scratch tapes. 


PG MT <unit number list> SCRATCHPOOL = <scratch pool name> 
PG MT <unit number list> POOL = <scratch pool name> 


Purges a tape and assigns a scratch pool name to it. 


PG MT <unit number list> (<density>) SCRATCHPOOL = <scratch pool name> 
PG MT <unit number list> (<density>) POOL = <scratch pool name> 


Purges a tape and assigns a density and a scratch pool name to it. 


PGL MT <unit number list> SCRATCHPOOL = <scratch pool name> 
PGL MT <unit number list> POOL = <scratch pool name> 


Purges a tape and assigns a scratch pool name to it. This command also locks the tape 
after it is purged so that no job can acquire the tape. 


As an alternative to PGL, you might want to use the HOLD command before you purge 


the tape with the PG command. You can then see the tape label information after the 
purge is completed. 


PGL MT <unit number list> (<density>) SCRATCHPOOL = <scratch pool name> 
PGL MT <unit number list> (<density>) POOL = <scratch pool name> 


Purges a tape and assigns a density and a scratch pool name to it. This command also 
locks the tape after it is purged so that no job can acquire the tape. 
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As an alternative to PGL, you might want to use the HOLD command before you purge 
the tape with the PG command. You can then see the tape label information after the 
purge is completed. 


PG PK <unit number> 
Relabels the disk pack identified by the unit number with the family name SCRATCH 


and makes it available to maintenance programs. This form of the PG command is 
intended primarily for maintenance and should not be used for normal operation. © 


PG PK <unit number> OLDNAME = <family name> 

For labeled disk packs, the PG command checks the family name of the pack. If the 
OLDNAME option is not specified, you must verify the old name through an ACCEPT 
response to an RSVP request. 

If you enter a W (Waiting Mix Entries) command, or have previously requested 
automatic display of current system status information by entering an ADM (Automatic 
Display Mode) command, the system displays the waiting entries. For example: 


<mix number> PK <pack number> is [<serial number>] <pack name> 
<mix number> ACCEPT: OLDNAME = <pack name> 


You must reply as follows: 
<mix number> AX OLDNAME = <pack name> 


The <pack name> entered is compared with the pack name in the pack label. If there 
is a mismatch, the task is terminated with the following error message: 


PKnn INCORRECT OLDNAME ENTERED -- RC/PG/LB NOT DONE 


The OWNER identification is verified before the OLDNAME. 


PG HC <unit number> 


Marks the Host Control (HC) unit identified by <unit number> as unlabeled. When 
the unit is in this state, it can be assigned toa BNA Version 1 station group. If the unit 
is the last unit of a given hub to be purged and the hubname was not specified in the 
group configuration, then the temporary hubmap is purged. 
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Examples 


PG MT 114 (1688) 
MT 114 WILL BE PURGED 
PG MT 66 
MT 66 WILL. BE PURGED 
PG HC 66 
HC 66 WILL BE PURGED 
PG MT 118 (168%) SCRATCHPOOL = ACCOUNTING 


MT 118 WILL BE PURGED 
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SEND (Send Message) 


The SEND (Send Message) command communicates with the network processor 
(NP) support library. It also initiates, terminates, and displays the status of the 
TAPESERVER library and the TAPEMANAGER library. 


Syntax | 
— SEND NP — <unit number> aes fa <NP unit-related command> 


TAPESERVER START 
TS QUIT 
TAPEMANAGER STATUS 
T™ 


<NP unit-related command> 


ANALYZE 
<filename 
AUTOLOAD 
BLOCKING 
BLOCKT IMEOUT 
blockval 
BUFFERSIZE 
bufsize 
DASNAME oy a faa al 
DIAGNOSTICS 
DUMP 
FREEINPUTS 
<freeval 
ID 
INITIALREADS 
<initval 
LOAD 
MAXINPUTS 
<maxval 
PROGRAMDUMP 
QUIT 


RELEASE 
SET 
RESET 
TANKING 


The <bufsize> construct specifies an integer in the range of 480 through 64000. 
The <blockval> construct specifies an integer in the range of 10 through 2000. 
~ The <dasname> value can be one of the following names: 


e INTRASYSTEM/BNAV2ICPINITIALIZATION for BNA Version 2 network 
processors (NPs) | 


e INTRASYSTEM/NTS_TWINAX INITIALIZATION for Workstation data link 
processors (DLPs) 


e INTRASYSTEM/HLCNICPINITIALIZATION for Host LAN Connection NPs 
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The <maxval> construct specifies an integer in the range of 10 through 127. 
The <freeval> construct specifies an integer in the range of 1 through 63. 


The <initval> construct specifies an integer in the range of 1 through 63. 


<option> 


AUTOLOAD 
Eee 
ERGs 
TANKING 


Network Processor System Commands 


The following are system commands applicable to network processors: 


SEND NP <unit number>: <NP unit-related command> 


Specifies that the NP unit-related command is to be sent to the network processor 
identified by unit number. The semantics of the NP unit-related command, as well as 
the responses to these messages, are defined by the NP support library; the text of the 
message is not inspected by the CONTROLLER or the system. The NP support library 
must be initialized before the SEND NP command can be used. 


If the unit is saved, it must be readied with the RY command before the NP support 
library can be used. The NP support library must have function names mapped to 
specific library code files with the SL command. Otherwise, if a ready NP exists, the 
system returns an RSVP request saying that the NP support library is not usable and 
the system waits for an SL command or a DS command. 


There are two types of NP unit-related command options: diagnostic and nondiagnostic. 
Diagnostic options can be entered only when a diagnostic NP support library is being 
used. In other words, the SEND NP diagnostic options cannot be used unless the NP 
support library is compiled with the DIAGNOSTICS option. Otherwise, an INVALID 
OPERATOR INPUT message is returned. Nondiagnostic options can be entered any 
time the NP support library is active. The following are the diagnostic options: 


e PROGRAMDUMP 


e ANALYZE 
e RELEASE 
e TANKING 


e DIAGNOSTICS 


The following are the nondiagnostic options: 


e DUMP 
e ID 
e LOAD 
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e AUTOLOAD 

@ QUIT 

e BLOCKTIMEOUT 
e BLOCKING 

e DASNAME 

e MAXINPUTS 

e FREEINPUTS 

e INITIALREADS 


e BUFFERSIZE 


The values of these options are stored in the file *NP/SUPPORT/RECOVERY 

on the family specified by a DL OVERLAY specification. If the file is removed 

or the DL OVERLAY command specifies a family that does not contain an 
*NP/SUPPORT/RECOVERY file, a new file is created with the default options the next 
time the NP support library is initialized. 


ANALYZE 
ANALYZE <file name> 


Analyze the tank file and print the analyzed file. If a file name is not specified, the 
active tank file is closed and renamed NP/TANKED/INPUT/xxx/<date>/<time>, it is 
analyzed and printed, and a new tank file is created. Ifa file name is specified, that file 
is analyzed. . 


AUTOLOAD 


Causes the driver stack to try to load firmware as soon as the driver stack is initialized. 
To turn the option on or off, precede the keyword AUTOLOAD with SET or RESET. 
The default is SET. 


BLOCKING 


Causes the network processor to block all incoming messages to the host. If the value of 
the BLOCKING option is SET, incoming messages are sent to the buffer of the network 
processor. When this buffer is full, the contents of the buffer are sent to the host as one 
set of messages. If the value of the BLOCKING option is RESET, then every incoming 

message is immediately sent to the host. 


The BLOCKING option can be set or reset at any time. To turn the option on or off, 
precede the keyword, BLOCKING, with SET or RESET. (The default value is SET.) The 
new setting does not take effect until a new NP/CONTROLLER/nnn stack is created 
for the unit (see “Considerations for Use”) or the NPSUPPORT library is reinitialized. 
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Reset blocking is not supported for ICP DLPs. If an attempt is made to reset blocking 
for an ICP DLP then a message indicating an NPSUPPORT protocol is displayed. If 
this message appears, do the following to regain communication with the ICP DLP: 


1. Set the blocking option for the DLP 
2. Reinitialize the ICP DLP 


BLOCKTIMEOUT 
BLOCKTIMEOUT <blockval> 


Display or set the amount of time (in milliseconds) the ICP should wait before sending 
a set of blocked messages to the host. The value of <blockval> can be changed at any 
time and takes effect immediately. The default value is 10 milliseconds. 


BUFFERSIZE 
BUFFERSIZE <bufsize> 


Display or set the size of the input buffers for messages from the network processor to 
the host. The minimum <bufsize> is 480 bytes, the maximum size is 64000 bytes, and 
the default size is 4000 bytes. The new buffer size takes effect immediately. 


DASNAME <dasname> 
DASNAME = <dasname> 


DASNAME is valid only for network processors (NPs). Use DASNAME to specify the 
name of the device application supervisor The MCP uses DASNAME to determine the 
correct supervisor for the device. 


Possible DASNAMEs are shown in the following table: 


Processor Type DASNAME 

BNAV2 NPs INTRASYSTEM/BNAV2ICPINITIALIZATION 
Workstation DLPs  * INTRASYSTEM/NTS_TWINAX_INITIALIZATION 
HLCN NPs INTRASYSTEM/HLCNICPINITIALIZATION 


If the supervisor for the device is not initialized, the operating system displays the 
following message on the ODT: 


MISSING DIRECTORY CONNECTION <dasname> 


DIAGNOSTICS 
Displays diagnostic messages about the network processor system. To turn this option 


on or off, precede the keyword, DIAGNOSTICS, with SET or RESET. The default value 
is RESET. 
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DUMP 


Causes a dump of the network processor. The internal memory state of the network 
processor is dumped into a file named DUMP/NP/MMDDYYYY, where MMDDYYYY 
is the date the DUMP request was made. A DUMP request is fatal to the network 
processor, because it clears the network processor. 


FREEINPUTS 
FREEINPUTS <freeval> 


Display or set the minimum number of available input buffers. If the number of 
available input buffers falls below this value, the support library starts a task to overlay 
the buffers being used by the host (not the buffers in use by the network processor). 
Setting this number too high causes frequent overlays and reduces throughput. . 
Setting it too low could force the network processor to wait for an available buffer, thus 
reducing throughput. The minimum value of <freeval> is 1, the maximum is 63, and 
the default value is 5. 


The value of FREEINPUTS can be changed at any time but does not take effect until 
a new NP/CONTROLLER/nnn stack is created for the unit (see “Considerations for 
Use”) or the NP support library is reinitialized. 


ID 


Displays compile and run-time information about the network processor. See the 
example for a sample display resulting from the ID message. 


INITIALREADS 
INITIALREADS <initval> 


Display or set the number of initial read operations that the support library will issue 
to the network processor. With more than one read operation outstanding, the network 
processor can complete one J/O and begin transferring data with the next I/O while 
the system processes the first. This option maximizes the throughput of the network 
processor. The value of INITIALREADS can be changed at any time but does not 
take effect until a new NP/CONTROLLER/nnn stack is created for the unit (see 
“Considerations for Use”) or the NP support library is reinitialized. 


LOAD 


Requests that the driver stack load firmware into the network processor. This message 
is used when AUTOLOAD has the value RESET. 


MAXINPUTS 
MAXINPUTS <maxval> 


Display or set the number of input buffers to be used by the NP support library for 

a particular network processor The minimum value is 10 buffers, the maximum is 
127 buffers, and the default value is 35 buffers. The value of MAXINPUTS can be 
changed at any time but does not take effect until a new NP/CONTROLLER/nnn stack 


8600 0940-000 2-51 


SEND (Send Message) (cont.) 


is created for the unit (see “Considerations for Use”) or the NPSUPPORT library is 
reinitialized. 


PROGRAMDUMP 
Causes a dump of the driver stack to a printer backup file (a backup disk, or BD, 
file). This file is labeled with the mix number of the frozen NP support library, for 


identification. PROGRAMDUMP is not fatal. The unit continues its scheduled 
activities after the dump. 


QUIT 
_ Requests that the driver stack terminate. Once QUIT is specified, no more connections 


to the driver stack are allowed. The driver stack waits for the active count to go to 0 
(zero) before terminating. 


RELEASE 
Does the following: 


e Closes the current tank file. 
e@ Changes the file name to NP/TANKED/INPUT/xxx/<date>/<time>. 


@ Opens a new tank file. 


This option is valid only when the system is in diagnostics mode. 


SET <option> 
RESET <option> 


Sets or resets any of the following options: AUTOLOAD, BLOCKING, DIAGNOSTICS, 
and TANKING. For more information, see the description of the individual options. 


TANKING 


Causes all incoming messages to be stored in a tank file. The tank file is named 
NP/TANKED/INPUT/<ICP unit number>. The tank file is created on the family 
specified in the DL OVERLAY command. To turn this option on and off, precede the 
keyword, TANKING, with SET or RESET. The default value is RESET. 
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Example 
This example shows the terminal display resulting from a SEND NP ID message: 
SEND NP157: ID 


NP SUPPORT LIBRARY: *SYSTEM/NPSUPPORT 
VERSION: 36.112.218;COMPILED: 8/27/98 @ 13:44:32 
FIRMWARE LEVEL: 200200000191 
DASNAME: INTRASYSTEM/BNAV2ZICPINITIALIZATION 
BUFFERSIZE: 4@88 BYTES 
BLOCKTIMEOUT: 18 MILLISECONDS 
MAXINPUTS: 38 
FREEINPUTS: 5 
INITIALREADS: 18 
ACTIVE UNITS: 5 
ACTIVE USERS: 23 
WAITING USERS: @ 
OUTPUT FILES: ON PACK 
RUN TIME OPTIONS: 
AUTOLOAD: SET 
DIAGNOSTICS: RESET 
TANKING: RESET 
BLOCKING: SET 
COMPILE TIME OPTIONS: 
DIAGNOSTICS 


Considerations for Use 


Certain changes specified in the SEND NP command (BLOCKING, 
FREEINPUTS, INITIALREADS, and MAXINPUTS) do not take effect until a new 
NP/CONTROLLER/nnn stack is created for the unit or the NP support library is 
reinitialized. To create a new stack, perform the following steps: 


1. Issuea SV NP <unit number> command to make the network processor 
inaccessible to the system. 


2. Issuea CL NP <unit number> command to clear the network processor. 


Issue an RY NP <unit number> command to make the network processor ready 
for use. 


Media Library System Commands 


The following are valid media library system commands. 


SEND TAPESERVER START 
SEND TS START 


Initiate the TAPESERVER library. An example of a TAPESERVER library is 
RoboHost A. 


8600 0940-000 2-53 


SEND (Send Message) (cont.) 


2-54 


SEND TAPESERVER START <text> 
SEND TS START <text> 


Initiate the TAPESERVER library and pass text to its initiation routine. 


SEND TAPESERVER QUIT 
SEND TS QUIT 


Terminate the TAPESERVER library. 


SEND TAPESERVER QUIT <text> 
SEND TS QUIT <text> 


Terminate the TAPESERVER library and send text to its termination routine. 


SEND TAPESERVER STATUS 
SEND TS STATUS 


Display the status of the TAPESERVER library. This command can return the 
following states: 

INACTIVE 

LINKING 

INITIALIZING 

ACTIVE 

TERMINATING 

WAITING TO DELINK 


SEND TAPEMANAGER START 
SEND TM START 


Initiate the TAPEMANAGER library. 


SEND TAPEMANAGER START <text> 
SEND TM START <text> 


Initiate the TAPEMANAGER library and pass text to its initiation routine. 


SEND TAPEMANAGER QUIT 
SEND TM QUIT 


Terminate the TAPEMANAGER library. 


SENDMANAGER QUIT <text> 
SEND TM QUIT <text> 


Terminate the TAPEMANAGER library and pass text to its termination routine. 
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SEND TAPEMANAGER STATUS 
SEND TM STATUS 


Display the status of the TAPEMANAGER library. This command can return the 
following states: 

e INACTIVE 

e LINKING 

e INITIALIZING 

ACTIVE 

TERMINATING 

e WAITING TO DELINK 


Example 1 


This example initiates the TAPESERVER library: 


SEND TS START 


TAPESERVER WILL START 


Example 2 
This example stops the TAPEMANAGER library: 
SEND TM QUIT 


TAPEMANAGER WILL QUIT 


Example 3 
This example asks for the status of the TAPESERVER library: 
SEND TS STATUS 
‘TAPESERVER OPTION SET, ACTIVE, MIXNUMBER 892 
As an alternate reply to example 2, you might also see the following: 


TAPESERVER OPTION RESET, INACTIVE 
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SN (Serial Number) and SNL (Serial Number Lock) 
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The SN (Serial Number) command purges and assigns a new or different serial number 
to a tape volume. It optionally specifies the recording density and assigns the tape toa 
scratch pool. : 


The tape drive unit where the tape volume is mounted must be ready, not in use, not 
marked as locked, and write-enabled. 


If you want to retain the old serial number, use the PG (Purge) command. 


Syntax 
SN MI —<SN option tistL-/\- (<density>) 
L SNL J /1\-<scratch pool 


<SN option list> 


a a : 
—Leunit number Ce i ee 
: . 
» 1 76\——<digit " 


a ae etter 


<density> 


208 
556 
880 
1258 
1626 
6250 
11069 
38080 


<scratch pool> 


SCRATCHPOOL <scratch pool name>—————_—___—____ 
Le pOOL eed cel 


<scratch pool name> 


Explanation 


SN MT <SN option list> 


Purges and assigns a serial number to the tapes mounted on the designated tape units. 
The serial number consists of up to six alphanumeric characters. If a number is used, it 
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is right-justified with leading zeros added. Any serial number containing alphabetic 
characters or any quoted alphanumeric string is left-justified with trailing blanks. 


SN MT <SN option list> (<density>) 


Purges and assigns the specified serial number and density (in bytes per inch) to all 
tapes mounted on the units in the unit number list. 


If the density you specify is not valid for the unit, the system displays the following 
message: 


MT <unit number> INVALID DENSITY SPECIFIED 


In such a case, the tape density is not changed, but the system still purges the tape and 
assigns the specified serial number. 


SNL MT <SN option list> 
SNL MT <SN option list> (<density>) 


Lock the specified tape units after purging, so that no job can automatically acquire 
the tapes as scratch tapes. The units must be readied through the RY (Ready) system 
command. 


SN MT <sn option list> SCRATCHPOOL = <scratch pool name> 
SN MT <sn option list> POOL = <scratch pool name> 


Purge, assign a serial number, and assign a specified scratch pool name to the tape 
mounted on the designated unit. 


SNL MT <sn option list> SCRATCHPOOL = <scratch pool name> 
SNL MT <sn option list> POOL = <scratch pool name> 


Purge, assign a serial number, and assign a specified scratch pool name to the tape 
mounted on the designated unit. This command also locks the tape after it is purged so 
that no task can access the tape. 


_ As an alternative to SNL, you might want to use the HOLD command before you purge 


the tape with an SN command. You can then see the tape label information after the 
purge is completed while you prevent tasks from accessing the tape. 


SN MT <sn option list> (<density>) SCRATCHPOOL = <scratch pool name> 
SN MT <sn option list> (<density>) POOL = <scratch pool name> 


Purge and assign the specified serial number, density, and scratch pool name to the 
tape. 
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SN (Serial Number) and SNL (Serial Number Lock) (cont.) 


SNL MT <sn option list> (<density>) SCRATCHPOOL = <scratch pool name> 
SNL MT <sn option list> (<density>) POOL = <scratch pool name> 


Purge and assign the specified serial number, density, and scratch pool name to the 
tape. This command also locks the tape after it is purged so that no job can acquire the 
tape. 

As an alternative to SNL, you might want to use the HOLD command before you purge 


the tape with an SN command. You can then see the tape label information after the 
purge is completed while you prevent tasks from accessing the tape. 


Example 1 
This example purges a tape mounted on unit 115, assigns a serial number called PART1 


and assigns a density of 1600. The PER MT command verifies that all the requested 
actions were performed. 


SN MT 115 PART1 (1699) 
MT 115 WILL BE SN-ED 
PER MT 


115*P [PART1 ] 1688 SCRATCH 


Example 2 


This example purges a tape mounted on unit 115, assigns the tape the serial number 
12345, and assigns the tape to a scratch pool named ACCOUNTING: 


SN MT 115 12345 POOL = ACCOUNTING 
MT 115 WILL BE SN-ED 
PER MT 


115*P [12345] 1608 $C RATCH POOL: ACCOUNTING 
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SYSOPS (System Options) 


SYSOPS (System Options) 


The SYSOPS (System Options) command is used to display or set the CCSVERSION, 
CONVENTION, LANGUAGE, TAPEMANAGER, TAPESERVER, TAPEEXPIRATION, 
and LABELFORMAT system options. 


Syntax 

a SYSTEMOPTIONS pe See ee See ye ere ne eee 
SYSOPS 

> 
ALL 
ke. 


/1\-— CCSVERSION 


<cesversion name 
ccsversion number 
/1\— LANGUAGE 
= language name 
/1\— CONVENTION 
ny = <convention name 
1 TAPEMANAGER 
oe ™ 


\ = <switch 
/1 TAPESERVER 
ie TS = <switch 
/1\— TAPEEXPIRATION 
= switch 
/1\— LABELFORMAT 
= ANSI69DEFAULT 
ANSI69 
ANSI87DEFAULT 
ANSI87 
<switch> 
SET 
RESET 
TRUE 
FALSE 
+ 
ON 
OFF 
YES 
NO 


The ccsversion name, language name, or convention name can be within the range of 
1 through 17 alphanumeric characters. The ccsversion number can be be within the 
range of 0 through 65535. . 


Explanation 


SYSTEMOPTIONS 
SYSOPS 


Display the current values for all the system options. 
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SYSOPS (System Options) (cont.) 


2-60 


SYSOPS ALL 


Displays the current values for all the system options and the possible values for these 
options. 


SYSOPS CCSVERSION 
SYSOPS CCSVERSION <ccsversion name> 
SYSOPS CCSVERSION <ccsversion number> 


Display or set the value for the CCSVERSION system option. If a new character set is 
specified, it is implemented after the next halt/load. 


SYSOPS LANGUAGE 
SYSOPS LANGUAGE <lIanguage name> 


Display or set the value for the LANGUAGE system option. If a new system language 
is specified, it is implemented after the next halt/load. 


SYSOPS CONVENTION 
SYSOPS CONVENTION <convention name> 


Display or set the value for the CONVENTION system option. 


SYSOPS TAPEMANAGER 
SYSOPS TAPEMANAGER <switch> 


Display or modify the value for the TAPEMANAGER system option. The default value 
is RESET. 


SYSOPS TAPESERVER 
SYSOPS TAPESERVER <switch> 


Display or modify the value for the TAPESERVER system option. The default value is 
RESET. 


SYSOPS TAPEEXPIRATION 
SYSOPS TAPEEXPIRATION <switch> 


Display or set the value of the TAPEEXPIRATION system option. The default is 
TRUE. When the MCP reads the labels on a tape and this option is FALSE, the MCP 
ignores the expiration date of the tape. When the MCP reads the labels on a tape and 
this option is TRUE, the MCP treats the tape as a scratch tape if the current date is 
past the expiration date and the tape is write-enabled. 


SYSOPS LABELFORMAT 


Displays the ANSI standard being used to format tape labels when you create tapes. 
The default is ANSIG69DEFAULT. 


8600 0940-000 


SYSOPS (System Options) (cont.) 


SYSOPS LABELFORMAT = ANSIG9DEFAULT 


If you choose this option, the ANSI69 standard is used to format tape labels when 
you create tape volumes. The option can be overridden by the setting of the 
LABELFORMAT task attribute. For information about the ANSI69 tape labels, refer 
to Appendix B. 


SYSOPS LABELFORMAT = ANSI87DEFAULT 


If you choose this option, the ANSI87 standard is used to format tape labels when 
you create tape volumes. The option can be overridden by the setting of the 
LABELFORMAT task attribute. For information about the ANSI87 tape labels, refer 
to Appendix B. 


Note: A Series software at the Mark 39.1 or earlier release level is incapable 
of reading tapes written in ANSI87 format. 

Example 1 

Use the following example to display the current values for the system options: 


SYSTEMOPTIONS 


The setting(s) for system options are as follows: 


The current CCSVERSION is ASERIESNATIVE ( @ ). 
The current LANGUAGE is ENGLISH. 

The current CONVENTION is ASERIESNATIVE. 
TAPESERVER is currently RESET. 

TAPEMANAGER is currently RESET. 

TAPEEXPIRATION is currently TRUE. 

LABELFORMAT is currently ANSI69DEFAULT. 
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SYSOPS (System Options) (cont.) 


Example 2 


- Use the following example to display all the current system options and all the available 
option values: 


SYSOPS ALL 


The setting(s) for system options are as follows: 


The current CCSVERSION is ASERIESNATIVE ( @ ). 
The current LANGUAGE is ENGLISH. 
The current CONVENTION is ASERIESNATIVE. 
- TAPESERVER is currently RESET. 
TAPEMANAGER is currently RESET. 
TAPEEXPIRATION is currently TRUE. 
LABELFORMAT is currently ANSI69DEFAULT. 


The following object(s) are available for use in each system option 
category: 


There are 12 CCSVERSIONs available. They are as follows: 


ASERIESNATIVE SWISS SWEDISH1 SPANISH 
CANADAEBCDIC CANADAGP . FRANCE NORWAY 
LATINGREEK TURKISH BRAZILIAN CZECHOSLOVAKIA 


The MCP BOUND LANGUAGE IS: ENGLISH 

There is 1 CONVENTION available. The CONVENTION is ASERIESNATIVE. 
The following system options may also be modified: 

The valid values for TAPESERVER are SET and RESET. 

The valid values for TAPEMANAGER are SET and RESET. 


The valid values for TAPEEXPIRATION are TRUE and FALSE. 
The valid values for LABELFORMAT are ANSI69DEFAULT and ANSI87DEFAULT. 
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SYSOPS (System Options) (cont.) 


Example 3 


Use the following example to set the value NORWAY for the CCSVERSION system 
option: 


SYSOPS CCSVERSION = NORWAY 


SYSTEM OPTION(S) are changed as follows: 


The current CCSVERSION is ASERIESNATIVE ( @ ). 
The CCSVERSION following the next HALTLOAD will be NORWAY ( 71 ). 


Example 4 


Use the following example when you want the system to call a TAPEMANAGER 
library for tape file requests: 


SYSOPS TAPEMANAGER = SET 


SYSTEM OPTION(S) are changed as follows: 


TAPEMANAGER is being SET 


Example 5 


Use the following example to indicate that the MCP is to ignore the expiration dates on 
tapes when it reads tape labels: 


SYSOPS TAPEEXPIRATION = FALSE 


SYSTEM OPTION(S) are changed as follows: 


TAPEEXPIRATION is FALSE 
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SYSOPS (System Options) (cont.) 


Example 6 
Use the following example when you want to indicate that all subsequent tapes are 


to be created with the ANSI87 standard format. Note that a LABELFORMAT task 
attribute specification can override the SYSOPS LABELFORMAT specification. 


SYSOPS LABELFORMAT = ANSI87DEFAULT 


SYSTEM OPTION(S) are changed as follows: 


LABELFORMAT is ANSI87DEFAULT 
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Section 3 


Programming Considerations 


This section documents tape management enhancements that relate to programming. 
Topics include the following: 


New file attributes 

- AUTOUNLOAD 

- SCRATCHPOOL 

New and revised task attributes 

— LABELFORMAT (new) 

- HISTORYCAUSE (revised) 

- HISTORYREASON (revised) 
New and revised SETSTATUS calls 


_- SEND (new) 


- HOLD (mew) 

- PGand PGL (revised) 

~ SNand SNL (revised) 
InfoGuard Security enhancements 
WEL considerations 


Logging enhancements 


File Attributes 


Two new file attributes, AUTOUNLOAD and SCRATCHPOOL, have been added to 


support tape management. Complete information follows. 


Note: 
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The information in this discussion is based on the A Series File 
Attributes Programming Reference Manual. 


AUTOUNLOAD 


AUTOUNLOAD 
Kinds Tape 
Interrogate Anytime 
Modify Anytime 
Type Mnemonic : 
Range DONTCARE, ON, OFF 
Default | DONTCARE 
Stored Permanently No 
Parameters None 
FTAM File Access Not Supported 
’ Host Services Logical I/O Not Supported 
Port Services Not Applicable 


Use the AUTOUNLOAD attribute to control the behavior of a file close action on 


tape drives or to determine the behavior of the tape drive when a CLOSE operation 

is performed on the file. When the AUTOUNLOAD value of a tape file is ON, the 
associated tape volumes automatically unload when a program has either released the 
unit or performed a reel switch. A program can use the AUTOUNLOAD attribute to 
override the effects of the AUTOUNLOAD option of the system command MODE (Unit 
Mode). 


The following are the possible mnemonic values, and their meanings: 


Mnemonic Action 


Causes a volume to unload automatically regardless of the mode of the unit | 
according to the following forms of the file close action: 


3-2 


CLOSE(F) 
CLOSE(F,REWIND) 
CLOSE(F,REEL) 
CLOSE(F, PURGE) 
CLOSE(F,*) 
CLOSE(F,LOCK) 
REWIND(F) 
FLOPEN: =FALSE 


Block exit close 


Implicit close on reel 
switch 


Rewound/unloaded 
Just rewound 
Rewound/unloaded 
Rewound/unloaded 
Position retained 
Rewound/unloaded 
Just rewound 

Just rewound 
Rewound/unloaded 


Rewound/unloaded 


continued 
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AUTOUNLOAD (cont.) 


continued 


Mnemonic Action 


Prevents a volume from being automatically unloaded regardless of the MODE 
of the unit. This value causes the traditional semantics of the file close action 
to.apply as follows: 


CLOSE(F) Just rewound 
CLOSE(F,REWIND) Just anal nd 
CLOSE(F,REEL) Just rewound 
CLOSE(F,PURGE) Just rewound 
CLOSE(F,*) Position retained 
CLOSE(F,LOCK) Rewound/unloaded 
REWIND(F) Just rewound 
F.LOPEN: =FALSE Just rewound 
Block exit close Just rewound 


Implicit close on reel Just rewound 
switch 


DONTCARE The default. This value indicates that the program does not care if the volume 
is automatically unloaded. The behavior taken at file close is based on the 
value of the AUTOUNLOAD option of the MODE (Unit Mode) system 
command. 


If you interrogate this attribute, the current value of the attribute is returned. This . 
value does not reflect the setting of the AUTOUNLOAD mode of a unit that might be 
associated with the logical file. 


If you have a program that requires that a tape volume remain mounted after it closes 
a file, use CLOSE(EREWIND) if file assignment to the unit is to be retained. If this 
version of CLOSE is not appropriate— that is, if the tape is to be accessed by a different 
logical file—you can set the AUTOUNLOAD file attribute to OFF before you execute 
the CLOSE(F) action. After the CLOSE(F) code, you can again set AUTOUNLOAD to 
DONTCARE, as shown in the following ALGOL example: 


F.AUTOUNLOAD := VALUE(OFF); 
CLOSE (F) ; 


F.AUTOUNLOAD := VALUE (DONTCARE) ; 
F.OPEN : = TRUE 


CLOSE(F) ; 
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AUTOUNLOAD cont.) 


It is possible to traverse a multivolume set without operator intervention by 
sequentially loading the tape cartridges in an automatic cartridge loader and by adding 
the following ALGOL code: 


F.AUTOUNLOAD := VALUE(ON); 


You can use the AUTOUNLOAD file attribute with the MODE AUTOUNLOAD 
system command to manage tape drive resources by unloading tapes when they are no 
longer needed. The drives then become available for use by other tasks. This factor is 
especially important in an automated tape library environment. 


This file attribute does not change the syntax of the programming languages except for 


WEL. For information on WFL syntax changes, see “Tape Management Enhancements 
in WFL” later in this section. 
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SCRATCHPOOL 


SCRATCHPOOL 


Kinds 

Interrogate 

Modify 

Type 

Range 

Default 

Stored Permanently 


Parameters 
FTAM File Access 


Host Services Logical I/O 


Port Services 


Tape 

Anytime 
Anytime 
Character string 
See following text 
Null string 

No 

None 

Not supported 
Not Supported 
Not applicable 


Use the SCRATCHPOOL attribute to specify that the tape volume or volumes to be 
used when you create a new file are to come from a specific pool of scratch tapes. You 
can place a scratch tape in a specific pool by naming that pool when you use the PG 
(Purge) or SN (System Number) system command. The value of the SCRATCHPOOL 
attribute is an identifier of 1 to 17 EBCDIC characters, left-justified in a field of blanks 
(a hyphen or an underscore is not permitted as the first character). If you set the 
SCRATCHPOOL value equal to a null string, the tape volume selected is not a member 
of any named scratch pool. 


If the SERIALNO file attribute has been specified for a particular member of a 
single volume or a multivolume set, the SCRATCHPOOL attribute is not taken into 
consideration when that volume is assigned. 


If a tape volume is closed with the PURGE option, and the SCRATCHPOOL value is 
not a null string, the SCRATCHPOOL value is used as the scratch pool name for the 
volume in the resulting purge operation. 


When you interrogate the SCRATCHPOOL attribute, the system always returns the 
specified value for that attribute. This action occurs because a tape volume is no longer 
considered a scratch tape when it is assigned. 
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Programming Considerations 


Task Attributes 


The following task attribute enhancements have been made to support tape 
management: 


e Anew task attribute, LABELFORMAT has been added. This task attribute 
specifies the default label format for tape volumes created by a process. 


e@ Value 14 has been defined for the HISTORYCAUSE task attribute. This value 
signifies a logical I/O error, as does value 8 (SOFTIOERRCAUSEV). The new value 
(SOFTIOERR2CAUSEV) enables the system to report additional logical I/O errors 
beyond the maximum of 256 that are already defined for SOFTIOERRCAUSEV. 


'@ The following HISTORYREASON task attribute values have been defined for 
cases where the HISTORYTYPE task attribute value is 4 (DSEDV) and the 
HISTORYCAUSE value is 14 (SOF TIOERR2CAUSEV): 


— 12 = Reopen stopped by TAPEMANAGER library 

— 18 = Creation stopped by TAPESERVER library 

— 14= Cannot open this file parameter 

— 15= Assignment stopped by TAPEMANAGER library 


The following pages present complete descriptions of each of these task attributes. 


Note: The information in this discussion is based on the A Series Task 
Attributes Programming Reference Manual. 
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LABELFORMAT 


LABELFORMAT 
Type: Mnemonic 
Range: UNSPECIFIED, ANSI69, ANSI87 
Default: UNSPECIFIED 
Read: Anytime 


Write: Anytime 


Inheritance: From parent 


Use the LABELFORMAT attribute to define the way tape volume labels written to 
tapes created by the task are to be formatted. 


The attribute has three possible values, as follows: 


LABELFORMAT Value Format of Tape Output Produced by Task 
ANSI87 Complies with ANSI X3.27 1987 standard 
ANSI69 ANSI87 if SECURITYLABELS volume attribute is set to 
TRUE; otherwise complies with ANSI X3.27 1969 
. standard 
UNSPECIFIED ANSI87 if SECURITYLABELS volume attribute is set to 


TRUE; otherwise format defined by LABELFORMAT 
system option 


Appendix B, “Standard Tape Formats,” illustrates the standard tape label formats 
supported by the A Series software. 


You can define which label format is to be used when a tape volume is first opened for 
output. The format used for the first file on the tape defines the format for the entire 
volume set. Once a file has been written to the tape, any user-supplied label-formatting 
specifications for the tape are ignored. 


You can use the LABELFORMAT attribute either to override an earlier 
specification — made with the LABELFORMAT system option or a previous 
LABELFORMAT task attribute specification —or to unconditionally request a 
particular label format for tape output produced by this task. 


You control the LABELFORMAT system option with the SYSOPS (System Options) 
system command described in Section 2, “System Commands.” 
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LABELFORMAT (cont.) 


The MCP determines which tape label format to use as follows: 


If the tape is assigned — that is, if one or more files have been written to it—all 
subsequent files written to that tape are written in the same format as the first file 
on the tape. The MCP ignores any user-supplied formatting specifications for the 
tape. 


The MCP uses ANSI87 format in writing the label when writing the first file (and 
subsequent files) in the volume set to that tape regardless of the settings of the 
LABELFORMAT system option and the LABELFORMAT task attribute if all the 
following situations are true: 


— The InfoGuard security subsystem is activated. 


- The TAPECHECK option is set to AUTOMATIC with the SECOPT (Security 
Options) system command. 


— The SECURITYLABELS volume attribute for the tape has a value of TRUE. 


If the SECURITYLABELS volume attribute is FALSE, the MCP uses ANSI87 
format to write labels on tapes created by the task if either of the following 
situations is true: 


- The LABELFORMAT task attribute is set to ANSI87. 


— The LABELFORMAT task attribute is set to UNSPECIFIED and the 
LABELFORMAT system option is set to ANSIS7DEFAULT. 


If the SECURITYLABELS volume attribute is FALSE, and you set the 
LABELFORMAT task attribute to ANSI69 but the LABELFORMAT system option 
is set to ANSI87DEFAULT, the MCP uses ANSI69 format in writing labels to the 
tape; that is, the task attribute overrides the system option. 


The LABELFORMAT system option has effect only when both of the following 
situations are true: 


— The SECURITYLABELS volume attribute is FALSE (the default value). 
—~ The LABELFORMAT task attribute is UNSPECIFIED (the default value). 


The default value of the LABELFORMAT system option is ANSI69DEFAULLT. - 
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HISTORYCAUSE 
Type 
Units 
Range 
Default 
Read Time 
Write Time 
Inheritance 
Overwrite Rules 
Host Services 
Attribute Number 
Synonym 


Restrictions 


Explanation 


HISTORYCAUSE 


Mnemonic 

Not applicable 
See “Explanation” below 
0 

Anytime 

Never 

None 

None (read-only) 
Supported 

67 

None 


None 


The HISTORYCAUSE task attribute specifies the general type of condition that caused 
the process to terminate abnormally or to be suspended. The HISTORYCAUSE value 
is the same as field [15:08] of the HISTORY task attribute. 


If the process did not terminate abnormally and is not suspended, the HISTORYCAUSE 
value is 0. No mnemonic is associated with this value. 


If the process terminated abnormally, then the HISTORYTYPE value is 4 (DSEDV), 
and the HISTORYCAUSE value is one of the following: 


Mnemonic Value 


(none) 0 
OPERATORCAUSEV 1 
PROGRAMCAUSEV 2 
RESOURCECAUSEV 3 
FAULTCAUSEV 4 
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Integer Value 


Meaning 


The process has not been initiated, is still 
in use, or terminated normally. 


The process was discontinued by an 
operator command. 


The process was deliberately terminated 
by a program action, or attempted an 
action that is not allowed by the operating 
system. 


The process was terminated for exceeding 
a resource limit, such as MAXPROCTIME 
or MAXIOTIME. 


The process was terminated because it 
requested a machine operation that could 
not be executed, such as dividing by zero 
or reading past the end of an array. 


continued 


HISTORYCAUSE cont.) 


continued 
Mnemonic Value 


SYSTEMCAUSEV 


DCERRCAUSEV 
IOERRCAUSEV 
SOFTIOERRCAUSEV 
NEWIOERRCAUSEV 


UNIMPLEMENTEDCAUSEV 


UNSPECIFIEDCAUSEV 


EBDMSERRCAUSEV 


NETWORKCAUSEV 


SOFTIOERR2CAUSEV or 
SOFTIOERR2V 


Integer Value 


5 


11 


12 


13: 


14 


Meaning 


The process was terminated because it | 
violated system parameters such as 
overlay row size and the amount of 
memory allowed. 


The process was terminated because of a 
data comm error. 


The process was terminated because of a 
physical 1/O error. 


The process was terminated because of a 
logical 1/O error. 


The process was terminated because of 
an error in opening a file. 


The process was terminated because it 
attempted to use a feature that has not 
been implemented. 


The process was terminated because of 
an error of an unknown type. 


The process was terminated because of a 
Data Management System I! (DMSII) 
error. 


The process was terminated because of a 
BNA error. 


The process was terminated because of a 
logical I/O error. This value enables 
additional 1/0 errors to be defined beyond 
the maximum number associated with 
value 8 (SOFTIOERRCAUSEV). 


If the process is suspended, then the HISTORYTYPE value is 3 (STEDV), and the 


HISTORYCAUSE value is one of the following: 


Mnemonic Value 


OPERATORCAUSEV 


PROGRAMCAUSEV 


SYSTEMCAUSEV 


NETWORKCAUSEV 


Integer Value 


1 


is 


Meaning 


The process was suspended by an 
operator command. 


The process was suspended because of a 


missing resource. 


The process was suspended because of a 
shortage of available memory. 


The process was suspended because of a 
BNA condition. 


For a list of process termination messages and their relationships to HISTORYCAUSE 
values, refer to the discussion of process history in the A Series Task Management 


Programming Guide. 
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HISTORYREASON 


HISTORYREASON 
Type Mnemonic 
Units Not applicable 
Range See “Explanation” below 
Default 0 
Read Time Anytime 
Write Time Never 
Inheritance None 
Overwrite Rules None (read-only) 
Host Services Supported 
Attribute Number 68 
Synonym — None 
Restrictions Not available in WFL 
Explanation 


The HISTORYREASON task attribute indicates the specific reason why a process 
terminated abnormally or was suspended. The HISTORYREASON value corresponds 
to field [23:08] of the HISTORY task attribute. 


Most HISTORYREASON integer values have mnemonics associated with them. 
Each mnemonic briefly describes one reason this HISTORYREASON integer value 
could have occurred. You can determine which mnemonic applies in a particular case 
by comparing the HISTORYREASON integer value with the HISTORYTYPE and 
HISTORYCAUSE values. 


If the process did not terminate abnormally and is not suspended, the 
HISTORYREASON value is 0. No mnemonic is associated with this value. 


The standard method of reading mnemonic-valued task attributes might yield 
confusing results if applied to HISTORYREASON. The following is an ALGOL example 
of this method: 


IF T.HISTORYREASON = VALUE(DIVIDEBYZEROV) THEN .. 


The mnemonic DIVIDEBYZERO is associated with a HISTORYREASON value of 1. 
The expression shown in the example evaluates to TRUE whenever HISTORYREASON 
has a value of 1. However, a HISTORYREASON value of 1 indicates a DIVIDEBYZERO 
error only if HISTORYTYPE = DSEDV and HISTORYCAUSE = FAULTCAUSEV. 


The following example shows a better method of reading HISTORYREASON. This 
example evaluates to TRUE only if a DIVIDEBYZERO error occurred: 


IF T.HISTORYTYPE = VALUE (DSEDV) 


AND T.HISTORYCAUSE = VALUE(FAULTCAUSEV) 
AND T.HISTORYREASON = VALUE(DIVIDEBYZEROV) THEN ... 
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HISTORYREASON (cont.) 


The following pages list the possible HISTORYREASON values for each combination 
of HISTORYTYPE and HISTORYCAUSE values. For HISTORYREASON values 
that have mnemonics, the mnemonics are listed under the column heading 
“Mnemonic Value.” For HISTORYREASON values that do not have mnemonics, 

a short explanatory phrase is listed under the column heading “History Reason (No 
Mnemonic).” 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 6 (DCERRCAUSEV) 


Integer Value History Reason (No Mnemonic) 
10 Message size error 
12 Unknown file or station 
13 File subtraction error 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 4 (FAULTCAUSEV) 


Integer Value Mnemonic Value 

1 DIVIDEBYZEROV 

2 EXPOVERFLOWV 

3 EXPUNDERFLOWV 
4 INVALIDINDEXV 

5 INTEGEROVERFLOWV 
6 INACTIVEQV 

7 MEMORYPROTECTV 
8 INVALIDOPV 

9 LOOPV 

10 MEMORYPARITYV 
11 SCANPARITYV 

12 INVALIDADDRESSV 
13 STACKOVERFLOWV 
14 STRINGPROTECTV 
15 PROGRAMMEDOPV 
16 FALSEASSERTV 

17 SEQUENCEERRORV 
18 INVALIDPCWV 

19 STACKUNDERFLOWV 
20 ZAPPEDV 
21 LIBLINKERRORV 
22 INVALIDINTV 
23 MEMFAIL1V 
24 PRIVILEGEDINSTRV 


N 
oi 


MEMPARANDFAIL1V 


continued 
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continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 4 (FAULTCAUSEV) 


Integer Value 
26 
27 
28 
29 
30 
35 
36 
37 
40 
41 
42 
43 
44 
45 
46 
47 


HISTORYREASON (cont.) 


Mnemonic Value 
MEMORYFAIL2V 
IOMERRV 
PINTANDFAIL1V 
PINTANDINVADDRV 
PROCINTERNALV 
PROCDIEDV 


_ PROCFAILEDV 


BCLPOINTERV 
DISKPARITYV 
EMODEVIOLATIONV 
NOACTIVELINKV 
PROCLINKPARITYV 
BADTABLEEDITV 
BOTTOMOFSTACKV 
RUNLIGHTOUTV 
STACKSTRUCTUREV 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 7 (IOERRCAUSEV) 


Integer Value 


0 


History Reason (No Mnemonic) 


Either a train printer I/O error occurred 
and could not be resolved, or the MCP 
procedure PATHRES did not successfully 
complete. PATHRES performs functions 
such as loading disk controller firmware. 


Direct !/O attribute error 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 13 (NETWORKCAUSEV) 
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Integer Value 


1 


Mnemonic Value 
NOHOSTV 
HOSTHALTLOADEDV 
HOSTNOTREACHABLEV 
USERPORTERRORV 
USERSIGNALERRORV 
TASKPROTOCOLERRORV 


HISTORYREASON (cont.) 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 9 (NEWIOERRV) 


Integer Value History Reason (No Mnemonic) 
20 Data error—no label 
37 Remote backup disk error 
38 Unknown station 
39 Invalid set of attributes 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 1 (OPERATORCAUSEV) 


Integer Value Mnemonic Value 
0 RSVPV 
1 CLEARUNITV 
2 . JUSTDSEDV 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 


Integer Value Mnemonic Value 

0 MISSINGCODEFILENAMEV 

1 MISSINGCODEFILEV 

3 INITACTIVETASKV 

4 NOEXTERNALRUNV 

5 VISITNONACTIVEV 

6 ILLEGALVISITV 

7 DYNCODEEOFV 

8 BADD1STRETCHV 

9 ATTREADONLYV 

11 NOTSESSIONNUMBERV 
12 NONANCESTRALTASKFILEV 
13 NOTIMPLEMENTEDV 

14 INVALIDACCESSCODEV 
15 INCOMPATIBLEBOXESV 
18 * DEATHINFAMILYV 

19 CRITICALBLOCKV 
20 BADGOTOV 
23 INVALIDPARAMETERV 
25 _ INCOMPATIBLECODEV 
26 NOTEXECUTABLEV 
rae | UNMATCHEDPARAMSV 
28 INVCOMPILERVV 


continued 
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continued 


HISTORYREASON (cont.) 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 
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Integer Value 
29 
30 
31 
32 
33 
37 
38 
39 
40 
41 
42 
43 
44 
46 
47 
48 
49 
50 
51 
52 
56 
57 
58 
59 
60 
61 
62 
63 
64 
65 
66 
67 
68 
69 


- Mnemonic Value 


SECURITYERRORV 
LIBMAINTV 
ILLEGALTASKXFERV 
BADRESIZEDEALLOCV 
READONLYONACTIVEV 
MISSINGINTRINSICV 
INCOMPATIBLELEVELV 
INFANTICIDEV 
NOTBOUNDV 
ILLEGALOWNARRAYV 
DIMSIZERRORV 
UPLEVELATTACHV 
ILLEGALSWAPV 
BADTASKATTRIBUTEV 
MISSINGCARDDECKV 
BADRESTARTV 
BADEVENTUSAGEV 
BADGIVELOCKV 
BADGETLOCKV 
ONLYMCSMAYSETV 
NONOWNERACCESSV 
COMPILERSONLYV 
TASKLI MITEXCEEDEDV 
AXBADARRAYV 
RUNTIMEWFLV 
COMPILERERRORV 
XSPARAMSV 
SORTKILLV 
MISSINGSYSTEMLIBV 
ALREADYSELECTEDV 
LIBMISSINGNAMEV 
LIBTYPEMISMATCHV 
LIBNOTINITIATEDV 
CYCLICPROVISIONV 


continued 
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HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 


Integer Value 
70 
71 
72 
73 
74 
75 
77 
78 
79 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
91 
92 
93 
94 
95 
96 
97 
98 
99 
100 
101 
102 
103 
104 


Mnemonic Value 


PREVIOUSLYFROZENLIBV 
LIBIMPLEMENTATIONERRORV 
FASTTASKFREEZEV — 
NONUNIQLIBV 
SAVELIBTASKNEVERCALLEDV 
LIBNEVERFROZEV 
BADLIBTASKV 
LIBFEATURENOTIMPLEMENTEDV 
BADCOMPILERINDEXV 
LIBNOTPROCESSEDORRUNV 
LIBMUSTBESEPARATESTACKV 
INVALIDPARAMV 
FORTRANERRV 
PLIRUNTIMEERRV 
INTRINSICSERRV 

MATHERRV 

FORMATERRV 
LIBDEIMPLEMENTATIONERRORV 
LIBLEVELINCOMPATIBLEV 
BADLIBTITLEV 
CANTLINKTOASYSTEMLIBV 
NOTASYSTEMLIBV 
NOTLIBRARYCAPABLEV 
LISTSERRORV 
LIBPARENTNOTALIBV 
BADLIBFUNCTIONV 
INVALIDATTVALUEV 
UNAUTHORIZEDLIBUSEV 
FOREIGNTASKINITFAILV 
PORTSERRORV 
LIBCANCELERRV 
INVALIDSAVECORELIMITV 
NONVISTASKFILEV 
BADINSCRIBEV 


continued 
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continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 
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Integer Value 
105 
106 
107 
108 
109 
110 
1g 
112 
lis 
114 
115 
116 
117 
118 
119 
120 
121 
122 
123 
124 
125 
126 
127 
128 
129 
130 
T3) 
132 
133 
134 
135 
136 
137 
138 


HISTORYREASON (cont.) 


Mnemonic Value 
BADERASEV 
CLIENTDIEDINACRV 
BADPOBOXUSAGEV 
INVALIDSTKNOV 
BADTCPREQV 
BYRESTRICTIONV 
LIBWRONGMARKLEVELV 
NOINITIATORV 
UPLEVELTASKASSIGNV 
FRAMEEXCEEDEDV 
CODEFILEINCOMPATIBLEWITHMCPV 
CODEFILENOTACTIVEV 
BADPPBV 
NOTAFASTTASKV 
FASTTASKINITTASKV 
FASTTASKNOPARAMSV 
FASTTASKNOTADSV 
FASTTASKBADEXCEPTIONTASKV 
STACKHASFAMILYV 
FASTTASKFAULTEDV 
DATABASEDIEDV 
LIBRARYDIEDV 
STACKHASUNITATTACHEDV 
RESTRICTEDACCESSV 
ATTWRITEONLYV 
NONANCESTRALEXCEPTEVENTV 
INCORRECTSYNTAXV 
ATTACCESSFAULTV 
INVALIDLSNV 
DATACOMMNOTACTIVEV 
VALUETOOLARGEV 
PRIVILEGEREQUIREDV - 
NONLOCALACCEPTEVENTV 
INVSCHEDACTV 


continued 


HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 


Integer Value 
139 
140 
141 
142 
143 
144 
145 
146 
147 
148 
149 


Mnemonic Value 
INVTIMESTATV 
INVREACTIVATEV 
INVSOURCEV 


INVDUMPPARAMV 


INVCPMACTIONV 
INVPREFACTIONV 
INVDISCONNECTV 
INVDESTINATIONV 
BLOCKHASNOSCWV 
PRPROVIDERGONEV: 
LIBWRONGCODEFILEV 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 3 (RESOURCECAUSEV) 


integer Value 


oO oan fF Ww NY YF OO 


Pe HY SS Se 
nO o Bf NY K OO 


Mnemonic Value 


PROCESSEXCEEDEDV 
IOEXCEEDEDV 
STACKEXCEEDEDV 
PRINTEXCEEDEDV 
PUNCHEXCEEDEDV 
CARDREADEXCEEDEDV 
MEMORYEXCEEDEDV 
TAPEEXCEEDEDV 
WAITEXCEEDEDV 
ELAPSEDEXCEEDEDV 
DISKLIMITEXCEEDEDV 
STRINGPOOLEXCEEDEDV 
SAVECORELIMITEXCEEDEDV 
CAUEXCEEDEDV 
SEGLIMITEXCEEDEDV 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


Integer Value 


0 
1 


History Reason (No Mnemonic) 


No error 


Label parity error 


continued 
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HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 
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Integer Value 


History Reason (No Mnemonic) 
Parity error on position 
Invalid translation 
Incompatible blocking 
Invalid output reverse 
Invalid input reverse 
Short tape blocking 
Invalid output file 

No buffer space 

No space in header 
Duplicated file 

Invalid direct I/O 
Exceeded resources 


No unit 


_ Invalid optional file 


Invalid final reel 

Too many names 

Failed entry 

Invalid MYUSE value 
Invalid NEWFILE value 
DCOPEN failed 

No write ring 

Failed volume entry 
Invalid unlabeled volume 
Invalid BLOCKSTRUCTURE or FILETYPE 
Invalid reel number 

Find routines failed 
Invalid backward seek 
Invalid read reverse 
Invalid seek 

Parity error on seek 
Read on output file 


Read on unopened file 


continued 


HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


integer Value History Reason (No Mnemonic) 

35 Read reverse on unopened file 

. 36 Seek on unopened file 
37 Space forward on output file 
38 Write on code file 
39 Write on input file 
40 Write on unopened file 
41 Buffer in use 
42 Up-level event 
43 Security error 
44 No room for buffer 
45 Unknown error 
46 Logic error 
47 Already closed . 
48 No read before rewrite 
49 No read before delete 
50 Delete on non-I/O file 
51 Invalid update file 
52 | Incompatible file organization 
53 Close not called 
54 File information block (FIB) stack 

transition error 

55 Locking error 

56 Kind list not allowed 
57 Dialogue communication failure with 

other host 

59 File not removed on disk 
60 File not cataloged 
61 Checkpoint file title not changed 
62 Write user label error 
63 RELEASEHEADER error 
64 Tried to write beyond end of file (EOF) 
65 Rewrite on non-l/O file 
66 Logical/physical file mismatch 


continued 
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continued 


HISTORYREASON (cont.) 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 
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Integer Value 
67 
68 
69 


70 


71 
72 
73 
74 
as 
78 
yb, 
80 
81 
82 
83 
84 
85 
86 
87 
88 
89 
90 
9] 
92 
93 
94 
95 
96 
97 
98 
99 


History Reason (No Mnemonic) 
Seek on output file 
Tape position error 


Distributed systems service (DSS) cannot 
handle this file. 


Access restricted to A Programming 
Language (APL) 


Open after close with lock 
Invalid write random 
Invalid read random 
Not closed 

Unexpected I/O error 
Data error 
Deleted/duplicate record 
Parity error 

I/O not done 

Invalid subfile 
Broadcast read error 
Subfile closed 

No available buffer 

No available message 
Port not connected 

End of file (EOF) 
Invalid short block read 
Break on output 

Unit in rewind 

Time limit exceeded 
File not available 

No file 


‘Mismatched genealogy 


Mismatched serial number 
File not resident 
Pack not present 


Invalid access code 


continued 
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HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


Integer Value History Reason (No Mnemonic) 

100 Foreign file open error 

101 Port offer error 

102 Invalid hostname for foreign file 

103 Data might have been lost. 

104 Record count error 

105 Block count error 

106 Host not reachable 

107 Write lockout 

108 FRAMESIZE and INTMODE values 
incompatible 

109 Binary |/O not allowed 

110 End of page 

111 BCL not allowed on this machine 

112 No continuation pack for audited file 

113 Cannot be audit file 

114 /O error occurred during flushing of 
buffers. 

115 Too many backup files 

116 Maximum audit length exceeded 

117 Unable to position file at end 

118 Unsupported function 

119 Bad use of use routines 

120 Must have usercode to use DSS 

121 Invalid port name 

122 Requires direct I/O 

123 SB must contain a disk/pack unit. 

124 EIO logic error 

125 Invalid array index 

126 Incompatible I/O length 

127 SIZEVISIBLE/FRAMESIZE/INTMODE value 
conflict . 

128 /O error occurred during closing of file. 

129 ; I/O support library error 


continued 
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continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 
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Integer Value 
130 
131 
132 
133 


134 


135 
136 


137 — 
138 


eo 
140 


141 


142 
143 
144 
145 
146 


147 
148 
149 
150 


151 
152 


153 
154 


155 
156 


HISTORYREASON (cont.) 


History Reason (No Mnemonic) 
\/O error 

INQ_LIST allocation failed 

End file not allowed 


I/O error changing host control (HC) unit 
access mask register (AMR) 


Unsupported protocol type 

Protocol error 

No resource to open port 

YOURHOST is not in YOURHOSTGROUP. 


User is not an authorized user of the 
application group. 


Support library unavailable 


Error in one or more port-subfiles open 
operations 


Error in one or more port-subfiles close 
operations 


Incompatible attribute value or values 
Function not available 

Unacceptable character set 
Networking not supported 


TRANSLATE=FORCESOFT not allowed 
with binary 1/O 


I/O error clearing adapter or unit 
Access restrictions not met 
Cannot create restricted file 
Security error on output tape open 
Cannot write on guard file 


Logical 1/0 not supported for this type of 
unit 


Attribute already set in physical file 


FAMILYOWNER conflicts with task 
usercode. 


Invalid 1/0 to coactive disk 


Coactive unit not in output mode 


continued 
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HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


Integer Value History Reason (No Mnemonic) 
157 Incompatible with this MCP version 
158 DSS dialogue number too large for logical 

/0 

159 I/O error occurred during closing of file. 
160 Tape-drive-mode-change operation failed. 
161 BYTES is not supported by this unit. 
162 Random add not allowed unless 


delete-capable 


163 Not delete-capable 

164 Record has not been read 

165 Beyond extend area 

166 _ Record not locked 

167 Record position occupied 

168 Sequential write not permitted to EFS 
direct file 

170 Attempt to exceed family limit 

171 Family integral limit exceeded 

172 Attempt to exceed temporary file limit 

174 Invalid write option specified 

LZS Invalid specification of ANYSIZEIO 

176 Area length exceeds maximum allowed. 

177 Logical file INTMODE incompatible with 
permanent file FRAMESIZE 

178 Incompatible FILESTRUCTURE 

179°: Permanent file FILESTRUCTURE must be 
STREAM. 

180 Logical file MAXRECSIZE inconsistent 
with permanent file MAXRECSIZE 

181 Logical file BLOCKSIZE inconsistent with 
permanent file BLOCKSIZE 

182 MAXRECSIZE exceeds AREALENGTH. 

183 Logical file FRAMESIZE incompatible with 


permanent file area length 
184 Unsupported parameter for this service 


continued 
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continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 
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Integer Value 


185 


186 
187 


188 


189 
190 


191 
192 
193 
194 


195 
196 
197 


198 


199 


200 


20] 
202 
203 


204 
205 
206 


207 
208 
209 
210 
211 


HISTORYREASON (cont.) 


History Reason (No Mnemonic) 


Local interprocess communication (IPC) 
not supported for this service 


Unsupported translation for this service 


DIOFILESTRUCTURE value requires 
FILESTRUCTURE to be set. 


Not in proper state for direct I/O to unit 
EIO 


Cannot access a file of this FILEKIND 
Open rejected by correspondent 
Close rejected by correspondent 
Endpoint not registered 


Invalid respond option 


| Service invalid for provider 


Provider restricted 
Connect time limit exceeded 


Correspondent does not support 
APPLICATIONCONTEXT value. 


Correspondent rejected 
DEFAULTPCONTEXT value. 


Invalid value or values for 
DEFINEDPCONTEXTSET 


Warning — DEFINEDPCONTEXTSET values 
have changed. 


Warning — port attribute ignored 
Invalid associated data 


Associated data too long 
Invalid attribute values for respond 
Invalid attribute values for AWAITOPEN 


DEPENDENTSPECS must be TRUE when 
DIOFILESTRUCTURE=SECTORSTREAM. 


Warning — initiator close collision 
Warning — responder close collision 
Endpoint incompatible with service 
Unsupported primitive 


Open failure in KEYEDIO library 


continued 
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HISTORYREASON (cont.) 


continued 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


Integer Value 
212 
213 


214 
215 


216 
217 


218 
219 
220 
221 
222 
223 
224 
225 


226 
227 
228 


229 
230 


231 
232 
23s 


233 


234 
235 
236 


237 
238 


3-26 


History Reason (No Mnemonic) 
Read reverse is not supported by this unit. 


Specified MAXRECSIZE is not supported 
by this unit. 


MAXRECSIZE must equal BLOCKSIZE for 
this unit. 


MCP does not support DMSII use of this 
FILESTRUCTURE. 


Insufficient disk space 


Operator entered OF (Optional File) 
system command. 


KEYEDIOI write error occurred. 
Unmatched DIOFILESTRUCTURE value 
Invalid connect TIMELIMIT value 
Error encoding data 

No data available to be read 

Error on broadcast write 

No buffer available for write 
Message truncated warning 

Open data was received. 

Open response data was received. 
Close request data was received. 
Close abort data was received. 
Close response data was received. 
More data to come 

Fault in use routine 


Logical file MINRECSIZE inconsistent with 
permanent file MINRECSIZE 


Logical file MINRECSIZE inconsistent with 
permanent file MINRECSIZE 


BASICSERVICE violation 
Action not valid in this FILESTATE 


Transparent LOCALSYNTAX cannot be 
supported for this subfile. 


Open aborted by correspondent. 


Open rejected — transient 


continued 
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continued 


HISTORYREASON cont.) 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 8 (SOFTIOERRCAUSEV) 


Integer Value 


239 


240 


241 
242 


243 
244 
245 


248 


249 
250 


251 
252 


History Reason (No Mnemonic) 


Warning: APPLICATIONCONTEXT and/or 
presentation context or contexts ignored 


Warning: abort request ASSOCIATEDDATA 
ignored 


Requested PROVIDERGROUP not defined 


Warning: PROVIDERGROUP must be 
defined before request can complete. 


Warning: initiating provider 
Write on read-only file 


During a file open, either the 
CENTRALSUPPORT library could not be 
accessed, or CENTRALSUPPORT reported 
an error related to CCSVERSION 
validation, INTMODE/EXTMODE 
validation, or translation tables 
availability. 


Operation requires ownership of all 
available tokens. 


Tape was changed while it was assigned. 


Word oriented access not supported for 
KIND=CD 


NETBIOS name in use 


Warning: switching between read and 
write might result in program being 
discontinued. 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 14 (SOFTIOERR2CAUSEV) 


Integer Value 


12 


13 
14 
15 


8600 0940-000 


Mnemonic Value 


Reopen stopped by TAPEMANAGER 
library 


Creation stopped by TAPESERVER library 
Cannot open this file parameter 


Assignment stopped by TAPEMANAGER 
library 
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HISTORYREASON (cont.) 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 5 (SYSTEMCAUSEV) 
Integer Value Mnemonic Value 
1 NOMEMV 
PARITYONPBITV 
ARRAYTOOLARGEV 
INCOMPATIBLEWFLJOBFILEV 
MFTABORTV 
SYSTEMEIV 


N OO ff W DY 


HISTORYTYPE = 4 (DSEDV), HISTORYCAUSE = 10 (UNIMPLEMENTEDCAUSEV) 


Integer Value Mnemonic Value 
1 DYNAMICOWNARRAYV 
aa DCHOLDV 


HISTORYTYPE = 3 (STEDV), HISTORYCAUSE = 13 (NETWORKCAUSEV) 


Integer Value Mnemonic Value 
DISCONNECTEDV 
3 SUSPENDEDV 


HISTORYTYPE = 3 (STEDV), HISTORYCAUSE = 1 (OPERATORCAUSEV) 


Integer Value Mnemonic Value 
1) (No mnemonic. This value means the 
command was entered from an ODT.) 
1 REMOTELYCAUSEDV 


HISTORYTYPE = 3 (STEDV), HISTORYCAUSE = 2 (PROGRAMCAUSEV) 
Integer Value Mnemonic Value 


1 RESPONSEREQUIRED 


HISTORYTYPE = 3 (STEDV), HISTORYCAUSE = 5 (SYSTEMCAUSEV) 
Integer Value Mnemonic Value 


1 WSSIZEEXCEEDV 


Examples 
Suppose that the following task attributes have the values shown: 
HISTORYTYPE = 4 (DSEDV) 


HISTORYCAUSE = 4 (FAULTCAUSEV) 
HISTORYREASON = 1 
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HISTORYREASON (cont.) 


In this context, a HISTORYREASON of 1 means DIVIDEBYZEROV In other words, 
the process was discontinued because it attempted to divide by zero. 


Now suppose that these task attributes have the following values: 
HISTORYTYPE = 4 (DSEDV) 


HISTORYCAUSE = 3 (RESOURCECAUSEV) 
HISTORYREASON = 1 


In this context, a HISTORYREASON of 1 means IJOEXCEEDEDYV In other words, 


the process was discontinued because it used more I/O time than was allowed by its 
-MAXIOTIME task attribute value. 
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Programming Considerations 


SETSTATUS Changes 


The following SETSTATUS changes have been made to support tape management: 


e The SEND TAPEMANAGER and SEND TAPESERVER calls have been added to 
SETSTATUS miscellaneous requests. 


e The following changes have been made to SETSTATUS unit type requests: 
— HOLD has been added as a new call. 
~- Changes have been made to the PG/PGL and SN/SNL calls. 


Complete information for each of these calls follows. 


Note: The information in this discussion is based on the A Series . 
GETSTATUS/SETSTATUS Programming Reference Manual. 
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SETSTATUS Request Type 2 (Miscellaneous Requests) 


SEND TAPEMANAGER and SEND TAPESERVER Calls 


Use these calls to initiate or to terminate either the TAPEMANAGER or the 


TAPESERVER library. 


Input 


Use the following input for this call: 


Parameter 
TYPE 
SUBTYPE 
VAL 


ARRAYROW 


Value or Description 
2 
88 
= SEND TAPESERVER 
2 = SEND TAPEMANAGER 
A[O] = 2 
A[1] = 1 if START 
A(1] = 2 if QUIT 
A[1] = 3 if STATUS 
A[2] = Length in bytes of optional text 


A{3] and following = optional text 


The following information describes words [2] through [4] that SETSTATUS returns 


in the array: 


Word 
A[2] 


A[3] 
AL4] 


Call 


Status 


The library state, enumerated as follows: 


0 = INACTIVE 

1 = LINKING 

2 = INITIALIZING 
3 = ACTIVE 


4 = TERMINATING 

5 = WAITING TO DELINK 

0 = NOTIN THE MIX, otherwise, the mix number 
The.library option, enumerated as follows: 

l= SET 

2 = RESET 


RSLT := SETSTATUS (2, 88, VAL, A); 
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SETSTATUS Request Type 2 (Miscellaneous Requests) (cont.) 


3-32 


Results 


SETSTATUS can return the following soft errors for this call: 


Soft Error Number Message 

4 PREVIOUSLY DONE 

58 NOT ALLOWED 

60 INVALID PARAM INDEX 
63 PARAM LENGTH ERROR 
69 INVALID VALUE 

95 OPTION IS NOT SET 


In addition, SETSTATUS can return Hard Error 57 fora SEND TM STATUS request 
if the array is not large enough to contain the response. 


Example 


For the system command SEND TAPESERVER START, use the following input: 


A[@] :=2 

A[1] :=1 

A[2] :=8 

RSLT := SETSTATUS (2, 88, 1, A); 
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SETSTATUS Request Type 5 (Unit Requests) 


HOLD Call 


Use this call either to prevent the system from assigning files to tape units or to allow 
the system to assign files to a unit that was previously the subject of a HOLD call. 


Input 


Use the following input for this call: 


Parameter Value or Description 
TYPE 5 
SUBTYPE 35 
VAL 0 = HOLD - 
1 = HOLD 
ARRAYROW © A[O] = Length of request 


A[1] to A[A[0}-1]] = Unit list 


Each entry in the unit number list is as follows: 


Array A Message 
Al[n].[31:08] Unit type; 13 = MT 
A[n].[38:06] . Number of additional words; must be 1 
Afn+1] Unit number 
Call © 


RSLT := SETSTATUS (5, 35, VAL, A); 


Results 


Bit 0 of the result is turned on if either a hard error or a soft error occurs. Bits [11:08] 
indicate the hard error. If bits [11:08] are equal to 0, a soft error occurred. 


SETSTATUS can return the following soft errors for this call: 


Soft Error Number Message 

24 UNIT IN USE 
41. INVALID UNIT TYPE 
167 PREVIOUSLY DONE 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


Example 


For the system command HOLD MT 56, use the following input: 


A[@] := 33 

A[1] := @ & 1 [38:96] & 13 [31:98]; 
A[2] := 56; 
RSLT := SETSTATUS (5, 35, 1, A); 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


PG and PGL Calls 
Use the PG call to purge tape, disk pack, or host control units. Use the PGL call to lock 
the tape units after they have been purged (the unit type must be MT). PG is not valid 


' for use with online mirrored packs. You must release the mirrored pack before the PG 
call can be issued. 


Input 


Use the following input for this call: 


Parameter Value or Description 
TYPE 5 
SUBTYPE 2 
VAL [0:1] = 1 if lock (PGL) 
(1:1] =0 
[7:6] = 0 


[15:8] = Density code: 

© 0 = Not specified (Density will not be changed.) 
1 = 800 bytes per inch 

2 = 556 bytes per inch 

3 = 200 bytes per inch 

4 = 1600 bytes per inch 

5 = 6250 bytes per inch 

6 = 38000 bytes per inch 

7 = 1250 bytes per inch 

@ 8 = 11000 bytes per inch 

[45:01] = 1 if a SCRATCHPOOL is to be assigned 


[46:01] = 1 if PG is to be performed synchronously 
ARRAYROW A{O] = 2 for MT or HC and 3 for PK 

AL1}.[31:08] = Unit type: 

@ 13: MT 

@ 17: PK 

@® 20: HC 


A[1].[38:06] = Number of additional words; must be 1 for MT or 
HC . 


Al2] = Unit number 


For a PG MT request, if bit [45:01] = 1, words 3 through 5 contain the pool name in 
substandard form. 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


For a PG PK request, the next few words of the entry in the unit number list are used 
to designate the OLDNAME. The first three bytes in word 3 must be specified for PG 
PK requests even if there is no OLDNAME (see the example). 


Array A Message 

A[3].[47:08] Byte length from this byte. to the end of entry 

A[3].[39:08] 0 

A[3].[31:08] Number of specifications (0 or 1) 

A[3].[23:08] Byte length from the next byte to the end of 
the entry 

A[3].[1 5:08] 11 (OLDNAME code) 

A[3].[07:08] Beginning of the family name 

A[4] through end of entry Continuation of the family name 

Call 


RSLT := SETSTATUS (5, 2, VAL, A)3 


Results 


SETSTATUS can return the following soft errors for PG and PGL: 


- Soft Error Number Message 
11 ADDITIONAL INFO NEEDED 
14 UNIT LOCKED 
4l INVALID UNIT TYPE 
45 NAME REQUIRED 
56 INVALID SYNTAX 
59 NAME TOO LONG 
77 INCOMPLETE ENTRY 
92 REQUIRED LOCK IN USE 
144 SYNCHRONOUS UNIT REQUEST FAILED 
167 INVALID FOR EXTERNAL 10 UNITS 
193 CANNOT PG A MIRRORED UNIT 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


Soft errors are reported in word 1 of the ARRAYROW in bits [46:08]. For soft error 
144, a result is returned in bits [15:16] of the word. The error values are as follows: 


@ 1= The tape was not purged for a reason related to the volume directory. 
e For values 88 through 96, 104, 115, and 177 through 187, refer to the table that 


follows: 

Value Related Message 

88 WRITE LOCK OUT 

89 SN REQUIRED 

90 WRITE PARITY ERROR 

91 WRITE ERROR 

92 UNIT NOT READY 

93 REQUIRES VOLUME DELETE | 

94 UNIT REWINDING 

95 UNABLE TO OBTAIN UNIT STATUS 

96 INVALID DENSITY SPECIFIED 

104 UNABLE TO SET DENSITY 

115 WARNING — DATA SECURITY ERASE FAILED TO COMPLETE 

177 PURGE REQUEST REJECTED BY TAPEMANAGER 

178 PURGE REQUEST REJECTED BY TAPESERVER 

179 INVALID SCRATCHPOOL SYNTAX | 

180 PURGED, BUT NOT CONFIRMED BY TAPESERVER 

181 SERIAL NUMBER REJECTED BY TAPEMANAGER 

182 SERIAL NUMBER REJECTED BY TAPESERVER 

183 SCRATCHPOOL REJECTED BY TAPEMANAGER 

184 SCRATCHPOOL REJECTED BY TAPESERVER 

185 PURGE ATTEMPT DSED IN TAPEMANAGER LIBRARY 

186 PURGE ATTEMPT DSED AWAITING TAPESERVER LIBRARY 

187 PURGE ATTEMPT DSED IN TAPESERVER LIBRARY 
Examples 


For the system command PG MT 30, use the following input: 


A[@] 
A[1] 


A[2] 


RSLT : 


8600 0940-000 


2= 33 
:= @ & 13 [31:88] %% MT unit type 
& 1 [38:86]; %% an additional word 
= 303 %% unit number 
= SETSTATUS(5,2,9,A);3 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


For the system command PGL MT 160 (1600), use the following input: 


A[@] := 3; 
A[1] := @ & 13 [31:98] 
& 1 [38:06]; 
A[2] := 168; 
RSLT := SETSTATUS (5, 2, 


1& 


VALUE (BPI169@) + 1 [15:8], 


A); 


MT unit type 
an additional word 
unit number 


%% PGL 


%% 1686 BPI 


For the system command PG PK 585, use the following input: 


A[@] := 4; 
A[1] := @ & 17 [31:98] 
& 2 [38:86]; 
A[2] <= 55; 
REPLACE POINTER (A[3], 8) BY 


RSLT 


48"93" 
48"g9" 
48"0" ; 
:= SETSTATUS (5, 2, ®, A); 


X& SS & & 


of 


se o 
x x 


‘oO 
¥ 


a & o& 


total words 

PK unit type 

2 additional words 
unit number 


total length 
g 
@ (no specs) 


For the system command PG PK 45 OLDNAME = USERPACK, use the following 


input: 


A[@] 
A[1] 


A[2] 
REPL 


RSLT 
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6; 
G@& 17 [31:28] 
& 4 [38:86]; 
s= 45; 
ACE POINTER (A[3], 8) BY 
48"@D" 
48"99" 
48"g1" 
48"g9" 
48"QB" 
8"USERPACK" ; 
:= SETSTATUS (5, 2, @, A); 


4 
« 


e 
° 


total words 

PK unit type 

4 additional words 
unit number 


total length 


one spec 
Tength of spec 
OLDNAME 

value 
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SN and SNL Calls 


SETSTATUS Request Type 5 (Unit Requests) (cont.) 


Use these calls to purge and to assign serial numbers to tape volumes and to designate 


their recording density. 


Input 


Use the following input for this call: 


Parameter 
TYPE 
SUBTYPE 
VAL 


ARRAYROW 


Call 


Value or Description 


5 

2 

[0:1] = 1 If lock (SNL) 
{1:1J]=1 

[7:6] = 0 


[15:8] = Density code: 
@ 0 = Not specified (Density will not be changed.) 
1 = 800 bytes per inch 
= 556 bytes per inch 
3 = 200 bytes per inch 
4 = 1600 bytes per inch 
5 = 6250 bytes per inch 
6 = 38000 bytes per inch 
7 = 1250 bytes per inch 
@ 8 = 11000 bytes per inch 
[45:01] = 1 if a SCRATCHPOOL is to be assigned 


[46:01] = 1 if SN is to be performed synchronously 
A[O] = 4 

Ali] = 0 & 2 [38:06] & unit type [31:08] 

(Refer to Appendix C for a list of unit type codes.) 
A[2] = Unit number 


AL3] = Serial number as 6 EBCDIC characters 


A[4] to A[6] = if bit [45:01] = 1, pool name in substandard form 


RSLT := SETSTATUS (5, 2, VAL, A); 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


Results | 


SETSTATUS can return the following soft errors that are applicable to SN and SNL: 


Soft Error Number Message _ 

10 INVALID NUMBER 

11 ADDITIONAL INFO NEEDED 

14 UNIT LOCKED 

Al INVALID UNIT TYPE 

45 NAME REQUIRED 

56 | INVALID SYNTAX 

57 CANNOT BE SNED . 

59 NAME TOO LONG 

77 _ INCOMPLETE ENTRY 

92 REQUIRED LOCK IN USE 

144 SYNCHRONOUS UNIT REQUEST FAILED 
167 INVALID FOR EXTERNAL IO UNITS 
193 CANNOT PG A MIRRORED UNIT 


Soft errors are reported in word 1 of the ARRAYROW in bits [46:08]. 


For soft error 144 (SYNCHRONOUS UNIT REQUEST FAILED), a result is returned 
in bits [15:16] of the word. The error values are as follows: 


e@ 1= The tape was not purged for a reason related to the volume directory. 


e For values 88 through 96, 104, 115, and 177 through 187, refer to the table that 


follows: 
Value Related Message 
88 WRITE LOCK OUT 
89 SN REQUIRED 
90 WRITE PARITY ERROR 
91 WRITE ERROR 
92 UNIT NOT READY 
93 REQUIRES VOLUME DELETE 
94 . UNIT REWINDING 
95 UNABLE TO OBTAIN UNIT STATUS 
96 INVALID DENSITY SPECIFIED 
104 UNABLE TO SET DENSITY 
115 WARNING — DATA SECURITY ERASE FAILED TO COMPLETE 
177 | PURGE REQUEST REJECTED BY TAPEMANAGER 
178 PURGE REQUEST REJECTED BY TAPESERVER 


continued 
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SETSTATUS Request Type 5 (Unit Requests) (cont.) 


continued 

Value Related Message 

179 INVALID SCRATCHPOOL SYNTAX 

180 PURGED, BUT NOT CONFIRMED BY TAPESERVER 

181 SERIAL NUMBER REJECTED BY TAPEMANAGER 

182 SERIAL NUMBER REJECTED BY TAPESERVER 

183 SCRATCHPOOL REJECTED BY TAPEMANAGER 

184 SCRATCHPOOL REJECTED BY TAPESERVER 

185 PURGE ATTEMPT DSED IN TAPEMANAGER LIBRARY 

186 PURGE ATTEMPT DSED AWAITING TAPESERVER LIBRARY 

187 PURGE ATTEMPT DSED IN TAPESERVER LIBRARY | 
Example 


For the system command SN MT 49 UNISYS (1600), use the following input: 


A[@] := 43 

A[1] := @ & 2 [38:06] & 13 [31:08] & 4 [15:08]; 

A[2] <= 493. 

A[3] := REPLACE POINTER (A[5]) BY 8"UNISYS"; 

RSLT := SETSTATUS (5, 2, 2 & (VALUE (BPI16@0)+1), A); 
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Programming Considerations 


Security Enhancements 


A new volume attribute, SECURITYLABELS, enables you to maintain the settings of 
security attributes in the tape label rather than in the volume directory on disk. When 
this information is on the tape itself, the tape is more easily transferred among hosts in 
a multihost environment. 


The values of these attributes override the corresponding values in the volume 
directory on disk if the following conditions are true: 


e@ The tape is mounted. 


e The SECURITYLABELS option was set to TRUE when the entry for the volume in 
the tape volume directory was established. See “Establishing the Volume Directory 
Entry,” later in this section. 


For information on how security information is maintained in the volume directory, 
see the A Series Security Administration Guide. 


SECURITYLABELS Volume Attribute 


SECURITYLABELS is a Boolean attribute that you can control with the WFL 
VOLUME statement, discussed later in this section. When SECURITYLABELS is 
TRUE, the values of the following volume security attributes are maintained in the 
tape labels: 

SECURITYTYPE 

SECURITYUSE 

SECURITYGUARD 


FAMILYOWNER 


When these attribute values are maintained in the tape label, they override the values 
in the volume directory on disk when the system determines whether a given input or 
output operation is permitted on a given tape. 


The following paragraphs describe the effects of setting the SECURITYLABELS 
attribute of a tape volume to TRUE. 


Establishing the Volume Directory Entry 


You can set the SECURITYLABELS attribute to TRUE in a VOLUME ADD statement 


that establishes an entry for the volume in the tape volume directory. 


Writing Files to the Volume 


3-42 


When you create the tape volume —that is, when you first write a file to it—the system 


determines the values of the SECURITYTYPE, SECURITYUSE, SECURITYGUARD, 
and FAMILYOWNER file attributes of the first file to be written to the volume. You 
have the normal options for setting these values: 
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Programming Considerations (cont.) 


e In declaration statements in the program that requests the operation 
e With file equation 


e Dynamically at compilation, run time, or both 


Any attribute not explicitly set receives the default value. See the A Series File 
Attributes Programming Reference Manual for details. The system then writes those 
values to the tape label and to the volume directory. 


When writing a continuation volume of a multivolume file, the system requires a 
volume that has a SECURITYLABELS value that matches the SECURITYLABELS 
value on the first volume of the set. When it finds an appropriate volume, the system 
automatically copies the security attribute values from the first volume to each 
continuation volume. 


Reading from the Volume 


When you subsequently bring the tape online, the system reads the security attribute 
values from the tape label and updates the volume directory on disk accordingly. 


ANSI87 Tape Format 


Use of the SECURITYLABELS volume attribute requires that the tape be formatted 
in compliance with the ANSI X3.27 1987 (ANSI87) standard. See “ANSI X3.27-1987 
(ANSI87) Tape Labels” in Appendix B for the ANSI87 formats. 


You can create ANSI87 tapes with either of the following methods: 


@ Use the SYSOPS (System Options) system command to set the LABELFORMAT 
system option value to AN pe DEEAUES as described in Section 2, “System 
Commands.” 


e Follow the guidelines under “Using the ANSI87 Tape Label Format” in Section 1, 
“Overview,” to set the LABELFORMAT task attribute to define ANSI87 as the 
tape label format to be used in creating a new tape volume. 


Note: If the SECURITYLABELS volume attribute is set for a tape volume, 
the system uses the ANSI87 standard when writing to that tape, 
regardless of any user-supplied specifications or the system option 
setting. 


Tape Management Enhancements in WFL 


The following information describes how the tape management enhancements affect 
the Work Flow Language (WFL). Unless otherwise stated, the section references in the — 
following text refer to the WFL Reference Manual. 


The enhancements change the syntax of the file attribute assignment, the ARCHIVE 


statements, and the VOLUME statement through the addition of the AUTOUNLOAD 
and SCRATCHPOOL file attributes, and the SECURITYLABELS volume attribute. 


8600 0940-000 3-43 


Programming Considerations (cont.) 


Using File Attributes 


The SCRATCHPOOL file attribute is added to Table 54, “File Attribute Types” in 
Section 5, “Task Initiation.” 


Table 3-1 shows how the attribute types listed in the File Attributes Reference Manual 
correspond to the types used in WFL. Attribute types that cannot be accessed through 
WEL are listed as not available. 


Table 3-1. Comparison of File Attribute Types to WFL Attribute Types 


1/0 Subsystem Type Corresponding WFL Type Valid File Attributes 


Boolean < Boolean file attribute> All Boolean attributes 


Event Not available None of the attributes 


integer <integer file attribute> All integer attributes 


WARNINGS 


continued 
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Table 3-1. Comparison of File Attribute Types to WFL Attribute Types (cont.) 


1/0 Subsystem Type Corresponding WFL Type Valid File Attributes 


Real <real file attribute> All real attributes 


Translatetable Not available None of the attributes 


Word <real file attribute> STATE 


TIMESTAMP 


_ Word <serial number fist> SERIALNO 


ARCHIVE Statements 


The SCRATCHPOOL and AUTOUNLOAD file attributes are added to the archive tape 
volume attribute list of the ARCHIVE statements in Section 6, “Statements.” 


<archive backup statement> 
— ARCHIVE FULL > 
- INCREMENTAL | Laarchive options! 
DIFFERENTIAL : 
> 


FROM —<archive disk volume 


> 
| faa F ——_—— | S [ —<task identifier>— ] J 
TO —<archive tape volume 
i 
L 3 —<archive task equation listo! 
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3-46 


<archive options > 


/1\ & — COMPARE - 
Lc & — VERIFY 
/1\- & — DSONERROR 


<archive disk volume> 


—<family Re a ee 
<archive disk volume attribute list 


<archive disk volume attribute list> 


ES 


/\7 7 DISK 
KIND — = PACK 
/1\-— SERIALNO —.= —<serial number list 


/1\— FAMILYINDEX — = —<integer expression 


<archive tape volume> 


—<tape ial ESSEC aie RPT ie a 
<archive tape volume attribute list 


<archive tape volume attribute list> 


é. 


acai 2 oe TAPE ) SS] 
KIND — = 
/\\- SERIALNO —- = —<serial number list 
SCRATCHPOOL — = —<scratch pool name 
/1\- DENSITY — = BPI289 
BP 1829 
BPI1259 
BP11629 
BPI6259 
BPI11999 
BPI38809 
/1\— FAMILYOWNER — = —— '''' 
* 
Beer 
/1\- AUTOUNLOAD — = ON 
OFF 
DONTCARE 
/1\- SECURITYUSE — = —<file mnemonic primary 
/1\- SECURITYTYPE — = —<file mnemonic primary 
/1\— SECURITYGUARD — = —<guard file title 


<scratch pool name> 


—<nane>—_ 
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ARCHIVE Statement Options 


The following table describes the syntax constructs added because of tape management 
enhancements: 


Syntax Construct Explanation 


<archive tape volume The following table describes the additional attributes of the archive 
attribute list> tape volume attribute list: 


Attribute Name Description 


SCRATCHPOOL Identifies the scratch pool from which the 
tape used for archiving is retrieved. The 
scratch pool name is a 17-character 
identifier without a default value. 


AUTOUNLOAD Determines whether or not a tape is 
unloaded when it is released by the 
system during a reel switch or a file close 
operation. If the value is ON, the tape is 
rewound and unloaded. If the value is 
OFF, the tape is not unloaded. If the value 
is DONTCARE, or if this attribute is not 
specified, tape behavior is controlled by 
the setting of the AUTOUNLOAD option of 

~ the MODE (Unit Mode) system command. 
See “MODE (Unit Mode)” in Section 2, 
“System Commands" of this Tape 
Management Guide. 


Example 


The following example shows how to back up all files under the usercode MYCODE to a 
tape volume called NEWTAPE from the scratch pool POOLI: 


ARCHIVE DIFFERENTIAL (MYCODE) = FROM TESTFAMILY 
TO NEWTAPE (KIND = TAPE, SCRATCHPOOL = POOL1); 


COPY or ADD Statement 


The SCRATCHPOOL and AUTOUNLOAD file attributes are added to the syntax 
diagram and text for the source volume attribute list and destination volume attribute 
list of the COPY or ADD statement in Section 6, “Statements.” These file attributes 
are also valid for the CANDE COPY and ADD commands. 
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<copy or add statement> 
aa COPY > 
ADD a - & maar a ie COMPARE ~ 7 & ag Geli CATALOG - 
AND VERIFY AND BACKUP 
> > 
SS > ° 
cS a 


/1\- FROMSTART 
/1\—<transfer service 


€ ? 
> ecopy reques b> 
[ —<task identifier>— ] 
> ; 
€ 
3 ——<task attribute assignment 


<transfer service> 


NFT 
HOSTSERVICES 
HS 


FTAM 
FTP 


<copy request> 


» —<copy file 
> 
| ——————., ———___ | 
/47\- TO —<destination volume 


<copy file> 


<file name 
AS —<file name 
<directory name 
AS —<directory name 
<file name>— ONTO —<file name 

<dir name>— ONTO —<directory name 


<FTP transform att list> 


> 


—-———$ $$ 
Cac | /1\— FTPTYPE — = EBCDICNONPRINT 
7 ASCIINONPRINT 
IMAGE 
/1\- FTPSTRUCTURE — = ee FTPFILE 
FTPRECORD 


<copy from group> 


oe 
ati genpy file FROM —<source volume>———_—_—_—_—___—_—_—_——_ 
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<destination volume> 


—<volume 1 a INTACT RST See We || 
<destination volume attribute list 


<source volume> 


—<volume rae 
<source volume attribute list 


<source volume attribute list> 


CDROM ) ———+ 
DISK 
PACK 
TAPE 
TAPE7 
TAPES 
TAPEPE 
KIND — = — # —<string primary 
/1\— SERIALNO — = —<serial number list 
/1\-— HOSTNAME — = —<hostname 
/1\— USERCODE — = —<log-on info 
/1\— FAMILYNAME — = —<family name 
/1\— FAMILYOWNER — = = rare 


* 


<usercode 
/1\— INTERCHANGE 
= —<Boolean expression 


/1\— AUTOUNLOAD — = ON 
OFF 
DONTCARE 
/1\-— CYCLE — = —<number 
/1\- VERSION — = —<number 
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<destination volume attribute list> 


€. 4 - 
DISK ) 
PACK 
TAPE 
TAPE7 
TAPE9 
TAPEPE 
KIND — = — # —<string primary: 
/1\— DENSITY — = BP1290 
BPI8@@ - 
BP11259 
BPI1620 
BP16259 
BPI38890 
eas SERIALNO — = —<serial number list 
SCRATCHPOOL — = —<scratch pool name 
/1\- HOSTNAME — = —<hostname 
/1\-— USERCODE — = —<log-on info 
/1\- FAMILYINDEX — = —<integer expression 
/1\— FAMILYOWNER — oe 


—{ 


* 


<usercode 
/1\— SINGLEUNIT 


/1\- INTERCHANGE 


= —<Boolean expression 


— = —<Boolean expression 
/1\- AUTOUNLOAD — = ON 


OFF 

DONTCARE 
/1\-— SAVEFACTOR —- = —<number 
/1\— SECURITYTYPE — = —<file mnemonic primary 
/1\— SECURITYUSE — = —<file mnemonic primary 
/1\— SECURITYGUARD — = —<file title 


/1\— SENSITIVEDATA 
= —<Boolean expression 


<scratch pool name> 


—<nane>— NNN 


Specifying File and Tape Volume Attributes 
The DENSITY option can be used only with the <destination volume attribute list> 


and not the <source volume attribute list>. For more information on this option, see 
the File Attributes Reference Manual. 
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The following table describes the syntax constructs added because of tape management 
enhancements: 


File Attribute Meaning 


AUTOUNLOAD Determines whether or not a tape is unloaded when it is released by the 
system during a reel switch or a file close operation. If the value is ON, the 
tape is rewound and unloaded. If the value is OFF, the tape is not 
unloaded. If the value is DONTCARE, or if this attribute is not specified, 
tape behavior is controlled by the setting of the AUTOUNLOAD option of 
the MODE (Unit Mode) system command. See “MODE (Unit Mode)” in 
Section 2 of this Tape Management Guide. 


If a reel is switched during a COPY and COMPARE operation, intermediate 
reels are not unloaded, regardless of the AUTOUNLOAD value, until the 
COMPARE phase is finished. 


SCRATCHPOOL Indicates the scratch pool from which the tape is retrieved when files are 
copied. The scratch pool name is a 17-character identifier without a default 
value. 


Examples 


The following examples illustrate various aspects of the COPY statement with the 
AUTOUNLOAD and SCRATCHPOOL file attributes: 


e This statement copies the file X as A/B from disk PACK to tape T. Because the 
value of the AUTOUNLOAD file attribute is ON, the tape is unloaded when the 
operation is completed. 

COPY X AS A/B FROM PACK TO T(KIND=TAPE, AUTOUNLOAD=ON) ; 

e This statement copies the file X as A/B from disk PACK to tape T in the TEST 

scratch pool: 


COPY X AS A/B FROM PACK TO T(KIND=TAPE, SCRATCHPOOL=TEST) ; 


VOLUME Statement 


The SECURITYLABELS volume attribute is added to the syntax diagram and text for 
the volume attribute list of the VOLUME statement in Section 6, “Statements.” 


<volume statement> 


— VOLUME —— ADD <volume name>-——————___________» 
CHANGE 7 
DELETE 


DESTROYED 
2- ( —<volume attribute list>— ) ——————__—__________LY_| 
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<volume name> 


DISK 

PACK 

SCRATCH 
<family name 
<tape name 


<tape name> 


—<nane>— AA 


<volume attribute list> 


DISK 
PACK 
TAPE 
TAPE7 
TAPES 
TAPEPE 
KIND —- = — # —<string primary 
/1*\— SERIALNO — = —<serial number list 
/1\— FAMILYOWNER — = ieee 
* 
<usercode 
/1\— MATCHONLYSERIALNO 


= —<Boolean expression 
/1\~ PERMANENTLYOWNED 


/1\- SECURITYLABELS 


= —<Boolean expression 


= —<Boolean expression 


/1\-— SECURITYTYPE — = —<file mnemonic primary 
/1i\— SECURITYGUARD — = —<file title 
/1\— SECURITYUSE — = —<file mnemonic primary 


Note: A VOLUME statement can set the SECURITYLABELS 
attribute to TRUE or the PERMANENTLYOWNED attribute 
to TRUE but not both. The system rejects a VOLUME . 
statement that specifies both SECURITYLABELS=TRUE and 
PERMANENTLYOWNED=TRUE. 


Explanation 


The following table explains the syntax construct added because of tape management 
enhancements: 


3.52 8600 0940-000 


Programming Considerations (cont.) 


File Attribute Meaning 


SECURITYLABELS When this attribute is set to TRUE, the security attributes 
SECURITYTYPE, SECURITYUSE, SECURITYGUARD, and 
FAMILYOWNER are maintained in the tape volume label. With 
this information on the tape itself, a tape can be transferred 
easily among hosts in a multihost environment. 


At volume creation, the system determines the security attribute 
values of the first file to be written to the volume. The system 
then writes those values to the tape label and to the volume 
directory. Each volume of a multivolume file must have a 
SECURITYLABELS value that matches the SECURITYLABELS 
value of the first volume. . 


When a tape with SECURITYLABELS set to TRUE comes online, 
the system reads the security attribute values from the tape label 
and updates the volume directory accordingly. 


Example 


This example establishes a volume directory entry for a tape volume named QFILES 
under the usercode AEDEPT. The security attribute values are stored in the tape 
volume label when the volume is created. 


VOLUME ADD QFILES (TAPE, SERIALNO = (111111) ,FAMILYOWNER = AEDEPT, 
SECURITYLABELS = TRUE, SECURITYTYPE = GUARDED, 
SECURITYGUARD = NEWGUARD); 


Logging Enhancements 


The following pages describe changes to LOGANALYZER and to the system log 
(SUMLOG). 


The LOGANALYZER selection option called VOLUMES now results in a revised 
output report format. 


Two LOGANALYZER configuration and maintenance options have been added 
for A Series users with a cartridge tape library (CTL) system that includes one or 
more cartridge library units (CLUs) and a RoboHost A TAPESERVER library. For 
more information, refer to the A Series RoboHost A Operation, Installation, and 
Administration Guide. 


The following system log (SUMLOG) entry formats have been changed: 


@ Major Type 1-Minor Type 5: File Open Entry (LOGOPENTYPE) 
@ Major Type 1-Minor Type 6: File Close Entry (LOGCLOSETYPE) 
e@ Major Type 6-Minor Type 3: SETSTATUS Call (LOGSETSTAT) 


‘@ Major Type 15-Minor Types 1, 2, 3, 4, 5, 12, 18: Volume Status Entry 
(LOGMAJVOL) 
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A complete description of the entry formats is given later in this section. 

The following additional system log changes for A Series users with RoboHost A 
cartridge tape library systems are listed in this section and described in the A Series 
RoboHost A Operation, Installation, and Administration Guide: 


® Major Type 2~Minor Type 24: CLU Hardware Report (CLUHWREPORT) 
@ Major Type 26: Tape Library Entry (LOGMAJ MEDIALIB) 


LOGANALYZER Output Illustration for VOLUMES Option 


The VOLUMES option defines the types of log entries that are being output. While the 
VOLUMES option is not new, the format of the output report has been revised. Figure 
3-1 shows a sample report. 
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A 


LOGANA 
hop as 
ANALY 


000-0760 0098 


RMON IBlza:s 233 


LY ER N: 13 DASUPPORT V N: 39. 106.0066, JOBFORHATTER VERSION; 39.106.0413. 
SISTEH/ AGB Pate aBtOR UB IRE vensTOhs Sb ite ARs 
REQUEST: 1015 VOLUMES (UNSORTED BY DEFAULT) 


SUMLOG af 906 Creu SiALOG BY Ah SY anEH Saris eee ON 10/10/1992 00:01:06 


TITLE = 


RENT 


FILE CONTAINS 47782 RECORDS FROM 10/10/1992 00:01:00 TO 10/12/1992 10:25:00 


Monday, October 12, 


10:18:04 VOL 


aU 10:18:17 VOL 
on 

ry 

? 

- 10:18:48 VOL 
S 

° 10:21:25 VOL 
c 

mn 

ra 10:21:29 VOL 
. 

ie 

= 

5 10:21:36 VOL 
° 

= 

co 

5 


10:22:04 VOL 


10:22:10 VOL 


NORMAL TERMENATION 


G¢c-e 


1992 
1579 


1580 


1582 


1594 


1592 


1595 


1598 


1599 


NOLUHE HOLD RTATUS CHANGE UNIT 193 [000198] PAY1 (HOLD) 
FILE tb FILE CREATION DATE 92286 CREATION SITE 2345 
CYCLE 1 VERSION O SAVEFACTOR 30 REEL 1 

VOLUME PURGED UNIT 193 [000198] PAYi (HOLD 

UATE  BWARLED CR one ae 2286 hoa SITE 2345 
EYeLe t JERS ON 0 EAVEPACTOR 36 REEL 1 


QIVBESARBCER BROT SEREALCRORBER whs® (Godiday Y POL: PAYROLL (HOLD) 


VOLUME HOLD gratus CHANGE UNIT 193 [009999] s CRATCH POOL: PAYROLL 


NEW ETLE CREATED ON VOLUME UNIT 193 [009999] ARS. 

FILE 10 FILE CREATION DATE 922 CREATION SITE 2345 
CYCLE 1 FYERSION 0 SAVEPA FACTOR 38 REEL 

VOLUHE ONLINE UNIT 193 [009999] ARS 

Pree BNP ILEG CREATION DATE, 92286 EOEATICM SITE 2345 
CYCLE i YERSION 0 SAVEFACTOR 38 REEL 1 

NOVUHE USED UNIT 193 [009999] ARS 

i eB PELEGO CREATION DATE 92286 _ CREATION SITE 2345 
EYCLE i VERSION 0 SAVEPACTOR 30 Reet i 

VOLUME ONLINE UNIT 193 [009999] ARS 

Pee PTT LEG CREATION DATE, 922 CREATION SITE 2345 
tYtte } VERSION 0 SAVEPACTOR 38 Reet l 
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Programming Considerations (cont.) 


Major Type 1—Minor Type 5: File Open Entry (LOGOPENTYPE) 


The File Open SUMLOG entry has been enhanced in the following ways: 
e Ifthe TAPEMANAGER library changed any file attributes of a tape file before the 
file was opened, then Word 7, Field [44: 1] is set to 1. 


e The high-order bits of the open error message number are now stored in Word 7, 
Field [48: 4]. The low-order bits of the open error message number continue to be 
stored in Field [15: 8]. 


Table 3-2 describes the complete format of the File Open entry, including the new field. 


Table 3-2. Major Type 1-Minor Type 5 


As described in the A Series System Software Support Reference 
Manual in Table 12-2, “First Four Log Entry Words” 


File size in units of words (valid for disk and pack only) 


LINK to internal name 


LINK to external name 


Open description word 
[47: 2] File Access Rule used 
1 = Actor rights 


2 = Declarer rights 


3 = Union of Actor and Declarer rights 


[45: 1] Value of DUMMYFILE attribute 


[44: 1] Attributes of the tape file were modified by the TAPEMANAGER 
library. 


continued 
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Programming Considerations (cont.) 


Table 3-2. Major Type 1—Minor Type 5 (cont.) 


Minor Type = 5 File Open Entry (LOGOPENTYPE) __ 
Words Description 


[43: 4] The high-order four bits of the open error message number. The 
low-order bits are stored in field [15: 8]. 


The open error message number identifies the system message that explains 
the open error. When an open error occurs, the system issues a Major 

Type 14-Minor Type 4 (INFO Message) log entry that contains the text of 
this system message. When such a log entry is printed by LOGANALYZER or 
appears in a job summary, the message text is preceded by the string 
MSRFIB and the open error message number. For example, open error 
message number 74 refers to system message MSRFIB74, “NOT CLOSED”. 


For processes discontinued by open errors, the open error message number 
also corresponds to the HISTORYREASON task attribute value. If the 
HISTORYTYPE value is 4 (DSEDV) and the HISTORYCAUSE value is 8 
(SOFTIOERRCAUSEV), then the open error message number equals the 
HISTORYREASON value. If the HISTORYTYPE value is 4 (DSEDV) and the 
HISTORYCAUSE value is 14 (SOFTIOERR2ZCAUSEV), then the open error 
message is equal to the HISTORYREASON value plus 256. For descriptions 
of the HISTORYTYPE, HISTORYCAUSE, and HISTORYREASON task 
attributes, refer to the A Series Task Attributes Programming 
Reference Manual. 


[31: 8] Logical type (See Table 12-21, “Peripheral Logical Types,” in the 
A Series System Software Support Reference Manual.) 


[23: 8] Value of the FILEKIND file attribute 


[15: 8] The low-order eight bits of the open error message number. For 
further information, refer to the description of Field [43: 4]. 


{ 7: 7] Value of the MYUSE file attribute: 
1 = INPUT 
2 = OUTPUT 
3 = I/O 
[ 0: 1] If this bit is 1, then [15: 8] contains an error code. 


LINK to access code 


OPEN parameters 
[46: 1] 1 if file is a valid subfile 
[41:10] Subfile index, if file is a valid subfile 


continued 
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Programming Considerations (cont.) 


Table 3-2. Major Type 1—Minor Type 5 (cont.) 


Minor Type = 5 File Open Entry (LOGOPENTYPE) 


Words Description 


[15: 4] Motion 
1 = Positioning requested 
2 = No positioning requested 
[11: 4] Position 
1 = AT FRONT 
2 = ATEND 
[ 7: 8] Open type 
For nonport files: 
- 1 = OPEN WAIT 
2 = AVAILABLE 
3 = OFFER 
4 = RESIDENT 
5 = PRESENT 
6 = PBT REEL SWITCH OPEN 
7 = STACK ASSIGNED OPEN REVERSE 
For port files: 
1 = WAIT 
2 = AVAILABLE 
3 = RETURN (OFFER) 
4 = DONTWAIT 


Device number 


Stack using the file (actor) 
. [47:12] Stack number 

{31:16] Job number 

[15:16] Task number 


Stack owning the file (declarer; same word format as Word 11) 


continued 


3-58 8600 0940-000 


Programming Considerations (cont.) 


Table 3-2. Major Type 1—Minor Type 5 (cont.) 


Minor Type = 5 File Open Entry (L.OGOPENTYPE) 


Words Description 


LINK to port file information. This LINK is 0 if this entry is not for a port file. 
If the LINK is nonzero, it points to an area used to contain a block of 
additional information for port files. The information contained in that block 
is listed in the following subtable. The location of each item is described by 
an offset from the start of this block of information. 


The LINKs within this block of information point to strings of characters. The 
length of each string is given in characters (not words) in the length field 
[39:20] of the LINK. The index field [19:20] of the LINK provides the word 
index in the log entry where the information starts. 


Offset 
0 


Contents 
LINK to YOURHOSTNAME value 
LINK to YOURNAME value 
Value of MAXSEGSIZE attribute 

LINK to YOURUSERCODE value 

Value of MYPORTADDRESS attribute 
Value of MYSUBPORTADDRESS attribute 
LINK to SERVICE value 

LINK to PROVIDERGROUP value 


LINK to the name of the provider selected, if the OPE 
succeeded; otherwise, O (zero) 


CONNECTTIMELIMIT value, if one was specified; 
otherwise, O (zero) 


oN DO oO fF W DY 


Initiation primitive invoked 
0 = OPEN 
1 = AWAITOPEN 

RESPOND invocation | 
1 = RESPOND(ACCEPTCLOSE) 
2 = RESPOND(REJECTCLOSE) 
31 = RESPOND was not invoked. 


continued 
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Programming Considerations (cont.) 


Table 3-2. Major Type 1—Minor Type 5 (cont.) 


Minor Type = 5 File Open Entry (LOGOPENTYPE) 


Words Description 

18 ASSOCIATED DATA transmission 
0 = ASSOCIATED DATA was sent. 
1 = ASSOCIATED DATA was not sent. 
ASSOCIATED DATA receipt 
0 = ASSOCIATED DATA was received. 
1 = ASSOCIATED DATA was not received. 


LINK to family name in substandard form 


Variable-length data pointed to by the LINKs in this entry 


For information on peripheral types, see Tables 12-21 through 12-24 in the A Series 
System Software Support Reference Manual. 


Major Type 1—Minor Type 6: File Close Entry (LOGCLOSETYPE) 


3-60 


The File Close SUMLOG entry has been enhanced so that the high-order bits of the 
close error message number are now stored in Word 7, Field [43: 4]. The low-order bits 
of the close error message number continue to be stored in Field [15: 8]. 


Table 3-3 describes the complete format of the File Close entry, including the new field. 


Table 3-3. Major Type 1—Minor Type 6 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 


Words Description 


As described in the A Series System Software Support Reference 
Manual in Table 12-2, “First Four Log Entry Words” 


File size in units of words (valid for disk and pack only) 


continued 
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Programming Considerations (cont.) 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


LINK to internal name (standard form) 


LINK to external name (standard form) 


Close description word 
47: 2] File Access Rule used 

1 = Actor rights 

2 = Declarer rights 

3 = Union of actor and declarer rights 
[45: 1] Value of DUMMYFILE file attribute 


[43: 4] The high-order four bits of the close error message number. The 
low-order bits are stored in field [15: 8]. 


The close error message number identifies the system message that explains 
the close error. When a close error occurs, the system issues a Major 


Type 14—Minor Type 4 (INFO Message) log entry that contains the text of 
this system message. When such a log entry is printed by LOGANALYZER or 
appears in a job Summary, the message text is preceded by the string 
MSRFIB and the close error message number. For example, close error 
message number 19 refers to system message MSRFIB16, “ILLEGAL 

_ OPTIONAL FILE”. 


For processes discontinued by close errors, the close error message number 
also corresponds to the HISTORYREASON task attribute value. If the 
HISTORYTYPE value is 4 (DSEDV) and the HISTORYCAUSE value is 8 
(SOFTIOERRCAUSEV), then the close error message number equals the 
HISTORYREASON value. If the HISTORYTYPE value is 4 (DSEDV) and the 
HISTORYCAUSE value is 14 (SOFTIOERR2ZCAUSEV), then the close error 
message is equal to the HISTORYREASON value plus 256. For descriptions 
of the HISTORYTYPE, HISTORYCAUSE, and HISTORYREASON task 
attributes, refer to the A Series Task Attributes Programming 
Reference Manual. 


(31: 8] Logical type (See Table 12-21, “Peripheral Logical Types,” in the 
A Series System Software Support Reference Manual.) 


[23: 8] Value of FILEKIND file attribute 


[15: 8] The low-order eight bits of the close error message number. For 
further information, refer to the description of Field [43: 4]. 


continued 
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Programming Considerations (cont.) 


3-62 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 


Words Description 

[ 7: 7] Value of MYUSE file attribute 
1 = INPUT 
2 = OUTPUT 
—3=/0 
{ O: 1] If this bit is a 1, then field [15: 8] contains an error code. 


Name qualification information 
[42:15] USASI generation number 
[27:11] SAVEFACTOR 


[16:17] Creation date in binary Julian format 


File blocking information 
[47:16] BLOCKSIZE 
[27:11] MINRECSIZE 
[15:16] MAXRECSIZE 


Transaction count (number of logical I/O operations) 


Elapsed I/O time 


Miscellaneous information 
For a disk file 
[47: 1] Installation-allocated disk (IAD) file 
[46: 
[44: 
[43: 
[42: 
[40: 
[32: 
[31: 


1] Permanent file 
1] Updated file 
1] CLOSE with CRUNCH 
1] Protected file 


1] Interchange disk pack file 


1] Duplicated file 


4] Number of duplicate copies 
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Programming Considerations (cont.) 


Table 3~3. Major Type 1-—Minor Type 6 (cont.) 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 


Words Description 
(23:24] Value of AREASIZE attribute 


For a tape file 


{15: 1] Contains 1 if the file was a multivolume file 
[14:15] Reel number 


For units other than tape or disk, this word contains Zeros. 


Serial number (six EBCDIC characters) for tape file. This word is 0 for other 
units. 


Unit information 
[47:16] INTMODE 
[25:14] CYCLE 
[11: 8] VERSION 
{ 0: 1] UNITS 


Close parameters 


[46: 1] Valid subfile 
[39:16] Subfile index, if file is a valid subfile 
(23: 8] Disposition 
1 = REWIND 
2 = NOREWIND 
3 = SAVE 
4 = LOCK 
5 = PURGE 
6 = CRUNCH 
7 = HERE 
8 = BLOCKEXIT 
[15: 8] Association 
1 = RELEASE 
2 = RETAIN 


continued 
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Programming Considerations (cont.) 


3-64 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 


Words - Description 

3 = RESERVE 
4 = DISABLE 
[ 7: 8] Close type 


For nonport files: 
1 = REGULAR CLOSE 
= REEL CLOSE 
3 = DONT WAIT 
For port files (note that disposition and association fields are not used): 
0 = BLOCKEXIT 
1 = NORMAL 
2 = DONTWAIT 


Physical I/O count 
[47:24] Read count 
[23:24] Write count 


LINK to FORMMESSAGE (standard form) 


LINK to port file information. This LINK is O if this entry is not for a port file. 
lf the LINK is nonzero, it points to an area used to contain a block of 

additional information for port files. The information contained in that block 
is listed in the following subtable. The location of each item is described by 
an offset from the start of this block of information. 


The LINKs within this block of information point to strings of characters. The 
length of each string is given in characters (not words) in the length field 
[39:20] of the LINK. The index field [19:20] of the LINK provides the word 
index in the log entry where the information starts. 


Offset Contents 
0 LINK to YOURHOSTNAME value 
1 ‘LINK to YOURNAME value 

2 Value of MAXSEGSIZE attribute 
3 LINK to YOURUSERCODE value 
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Programming Considerations (cont.) 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


Number of messages sent 
Number of messages received 
Number of segments sent 
Number of segments received 


Number of retransmissions 


Number of control frames sent 

Value of MYPORTADDRESS attribute 

Value of MYSUBPORTADDRESS attribute 

LINK to SERVICE value 

LINK to PROVIDERGROUP value 

LINK to provider selected, if the CLOSE succeeded; 


otherwise, O (zero) 
CLOSE type 
0 = ABORT 
1 = REQUEST 
INITIATOR 
O = Locally initiated 
1 = Correspondent initiated 
2 = Provider initiated 
RESPOND invocation 
1 = RESPOND(ACCEPTCLOSE). 
2= RESPOND(REJECTCLOSE) 
31 = RESPOND was not invoked. 
ASSOCIATED DATA transmission 
0 = ASSOCIATED DATA was sent. 
1 = ASSOCIATED DATA was not sent. 


continued 
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Programming Considerations (cont.) 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 


Words . Description 


ASSOCIATED DATA receipt 
0 = ASSOCIATED DATA was received. 
1 = ASSOCIATED DATA was not received. 


External device number 

Stack using the file (actor) 

[47:12] Stack number 

[31:16] Job number 

[15:16] Task number 

Stack owning the file (declarer; same field format as Word 20) 
LINK to family name in substandard form 

Number of physical read operations initiated for the file 
Number of physical write operations initiated for the file 
FILESTRUCTURE for disk files. This word is —1 for other kinds of files. 
0 = ALIGNED180 

1 = STREAM 

5 = BLOCKED 

Buffer size in words 

Buffer size source 


1 The buffer size for the file was based on the BLOCKSIZE 
file attribute because the BUFFERSIZE attribute is not 
applicable to this file. 


The buffer size for the file was specified through an 
assignment to the BUFFERSIZE file attribute. 


The buffer size for the file was based on the 
BUFFERGOAL memory management parameter of the 
SF (Set Factors) system command. 


continued 
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Programming Considerations (cont.) 


Table 3-3. Major Type 1—Minor Type 6 (cont.) 


Minor Type = 6 File Close Entry (LOGCLOSETYPE) 
Words Description 
Density for tape files. This word is —1 for other units. 
0 = BPI800 
1 = BPI556 
2 = BPI200 
3 = BPI1600 
4 = BPI6250 
5 = BPi38000 
6 = BPI1250 
7 = BPI11000 
Physical Data Representation 
[47:16] EXTMODE 
[31:16] CCSVERSION 
[15:01] CCSVERSION validity bit (1 if CCSVERSION contains a valid value) 


Variable-length data pointed to by the LINKs in this entry 


For information on peripheral types, see Tables 12-21 through 12-24 in the A Series 
System Software Support Reference Manual. 


Major Type 2—Minor Type 24: CLU Hardware Report 
(CLUHWREPORT) 


A new log entry minor type has been added to record cartridge library unit (CLU) 
hardware activity. This entry is relevant only to RoboHost A users. Refer to the 
A Series RoboHost A Operations, Installation, and Administration Guide for a 
description of the entry format. . 
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Programming Considerations (cont.) 


Major Type 6—Minor Type 3: SETSTATUS Call (LOGSETSTAT) 


3-68 


The SETSTATUS call log entry has been enhanced so that word n + 9 stores the value 
of the V parameter of SETSTATUS. 


Table 3-4 describes the complete format of this log entry, including the new field. 


Table 3-4. Major Type 6—Minor Type 3 


Minor Type = 3 SETSTATUS Cail Entry (LOGSETSTAT) 


Words Description 


As described in the A Series System Software Support Reference 
Manual in Table 12-2, “First Four Log Entry Words” 


Information regarding parameters to SETSTATUS call. 
[47: 8] TYPE, the first parameter _ 

[39: 8] SUBTYPE, the second parameter 

(31: 8] V, the third parameter 

[15:16] Number of words to follow in the entry 


5 for m words Contents of the array parameter to SETSTATUS, where 7 is the number of 
words specified in field [15:16] of Word 4 


If the length of the entire log record is greater than m + 5 words, the remaining words have the 
following meaning: 


n+5 Identity information code 
[47:06] Length of fixed part of entry in words 
[41:10] Entire length of identity information 
Miscellaneous identity information 
[07:08] Source of SETSTATUS command 
= From ODT 
‘2 = From remote ODT 
3 = From BNA connected host 
4 = From DCKEYIN 
= From MCS 
LINK to SOURCENAME task attribute value 
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Programming Considerations (cont.) 


Table 3-4. Major Type 6—Minor Type 3 (cont.) 


Minor Type = 3 SETSTATUS Call Entry (LOGSETSTAT) 


Words Description 


LINK to USERCODE task attribute value. This word is used only if the 
source of the SETSTATUS command was a BNA connected host (that is, 
field [07:08] of Wordn + 6 storesa 3). 


The V (third parameter) value of SETSTATUS 


Note that the field [31: 8] of Word 4 differs from the third parameter value (V) in the 


following cases: 
Case Value in Word 4 [31: 8] 
AD or DD | V&(V.[10: 1})£ 1: 11 & (V[39: 1]) 2: 1) 
PP or XP IF V =—1 THEN 6 ELSE V 
SW- IF V = -1 THEN 6 ELSE V 


Note: The SETSTATUS call entry records a call to SETSTATUS, which is 
the MCP procedure called to carry out operator input commands. 
Thus, these records show most operator input that changes the status 
of the system, such as time and date changes, tapes purged, and tasks 
discontinued. 


8600 0940-000 3-69 


Programming Considerations (cont.) 


Major Type 15—Minor Types 1-5, 12, 13: Volume Status Entry 
(LOGMAJVOL) 


The Volume Status SUMLOG entries have been enhanced in the following areas: 


@ The Minor Type 12 (Tape Volume Used) entry has been added. This log entry is 
issued when a process first opens a tape file on a particular tape volume. This log 
entry is not issued if the same > process opens subsequent tape files on the same tape 
volume. 


e The Minor Type 13 (Tape Volume Hold) entry has been added. This log entry is 
issued when a HOLD (Hold Unit for Operator Use) system command changes the 
HOLD status of a tape unit. 


e The Minor Type 5 (Tape Volume NEWFILE) is now issued for all cases in which a 
tape file is assigned to a new tape file on a tape volume. Formerly, this log entry 
was not issued if the new tape file was unlabeled. 


e Word 7, Field [42: 1] is now set if the volume is unavailable for file assignment 
because of a HOLD command in effect for the unit. 


e@ For Minor Type 3 (Tape Volume Purged) log entries, Words 22 through 24 store the 
scratch pool name in EBCDIC characters. The first byte is a binary count of the 
number of characters in the scratch pool name. 


Table 3-5 describes the complete format of the Volume Status log entries for Minor 
Types 1 through 5, 12, and 18. 


Table 3~5. Major Type 15-Minor Types 1 through 5, 12, and 13 


Minor Type = 1 Volume Online (LOGVOLON) 

Minor Type = 2 Volume Offline (LOGVOLOFF) 

Minor Type = 3 Tape Volume Purged (LOGVOLPG) 

Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5 Tape Volume NEWFILE (LOGVOLNEW) 
Minor Type = 12 Tape Volume Used File (LOGVOLUSED) 
Minor Type = 13 Tape Volume Hold (LOGVOLHOLD) 


Words Description ; 


As described in the A Series System Software Support Reference 
Manual in Table 12-2, “First Four Log Entry Words” 


External device number 


Peripheral Description 


[47: 8] Peripheral Type. (See Table 12-21, “Peripheral Logical Types,” i 
the A Series System Software Support Reference Manual.) 
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Programming Considerations (cont.) 


Table 3-5. Major Type 15-Minor Types 1 through 5, 12, and 13 (cont.) 


Minor Type = 1 Volume Online (LOGVOLON) 

Minor Type = 2 Volume Offline (LOGVOLOFF) 

Minor Type = 3 Tape Volume Purged (LOGVOLPG) 

Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5 Tape Volume NEWFILE (LOGVOLNEW) 
Minor Type = 12 Tape Volume Used File (LOGVOLUSED) 
Minor Type = 13 Tape Volume Hold (LOGVOLHOLD) 


Words Description 


[39: 8] Peripheral subtype. (See Table 12—22, “Peripheral Subtypes,” in 
the A Series System Software Support Reference Manual.) 


[31: 9] Density. (See Table 12-23, “Peripheral Densities,” in the A Series 
System Software Support Reference Manual.) 


Serial Number in EBCDIC characters 


Volume Status 
[47: 1] SET if volume is a scratch volume 


[46: 1] SET if error is detected in label (parts of log entry might be missing 
or invalid) 


[45: 1] SET if volume is listed in the volume library 
[44: 1] Has a write ring 
[43: 1] SET if volume is listed in the volume directory 


[42: 1] SET if volume is unavailable for file assignment because of a HOLD 
command in effect for the unit , 


If the volume is a scratch volume, the following rules determine which of Words 8 through 24 
are filled in: 


@ For Minor Types 1, 2, 4, and 5, only words 22 through 24 (scratch pool) are filled in. 


@ For Minor Type 3 (Tape Volume Purged) entries, only the following words are filled in: 17 
(new serial number), 18 (new density), and 22 through 24 (scratch pool). 


8-10 Volume or family name (first byte is binary number of characters that 
follow) 


The remaining words of the log entry differ depending on whether the volume is a disk or tape 
volume. 


continued 
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Programming Considerations (cont.) 


Table 3-5. Major Type 15—Minor Types 1 through 5, 12, and 13 (cont.) 


Minor Type = 1 Volume Online (LOGVOLON) 

Minor Type = 2 Volume Offline (LOGVOLOFF) 

Minor Type = 3 Tape Volume Purged (LOGVOLPG) 
Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5 Tape Volume NEWFILE (LOGVOLNEW) 
Minor Type = 12 Tape Volume Used File (LOGVOLUSED) 
Minor Type = 13 Tape Volume Hold (LOGVOLHOLD) 


Words — Description 


For disk 
volumes: 


11 Status fields: 
[47: 1] SET if disk has directory (for example, base pack) 
[46: 1] SET if disk is interchange mode 
[45: 1] SET if disk is IAD 
[44: 1] SET if disk is mirrored 
The remainder of the disk log entry is not filled in for interchange-mode packs. 
12 Family index number 


13. Family serial number in EBCDIC characters (serial number of original base 
pack for family) 


14 Family creation date (Julian = YYDDD) 


15 Family creation time (where time is the number of 2.4 microsecond clock 
ticks since midnight) 


16 System serial number of site where family was originally created 


For tape 
volumes: 


11 [20: 1] Parity 
[16: 1] SET if LABELKIND field is valid 
(15: 4] LABELKIND attribute 


[47: 8] Label level 
3 = ANSI69 label 
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Programming Considerations (cont.) 


Table 3-5. Major Type 15—Minor Types 1 through 5, 12, and 13 (cont.) 


Minor Type = 1 Volume Online (LOGVOLON) 

Minor Type = 2 Volume Offline (LOGVOLOFF) 

Minor Type = 3 Tape Volume Purged (LOGVOLPG) 

Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5 Tape Volume NEWFILE (LOGVOLNEW) 
Minor Type = 12 Tape Volume Used File (L.OGVOLUSED) 
Minor Type = 13 Tape Volume Hold (LOGVOLHOLD) 


Words Description 


4 = ANSI87 label 


Note: Prior to the Mark 3.9.2 release, the label level was stored 
in field [47: 9]. 


[37:14] Cycle 
[23: 8] Version 
[14:15] FILESECTION number 


[47:16] System serial number of system that created file 


[31: 4] GENERATION attribute 


[27:11] SAVEFACTOR attribute 
[16:17] CREATIONDATE (Julian = YYDDD) 


Tape usercode or zeros (first byte is binary count of characters in the 
usercode) 


New serial number of tape volume. (This can differ from original serial 
number above for SN MT entry.) 


New density 


[31: 9] New density of tape volume. This can differ from original density 
above for SN MT entry. (See Table 12-23, “Peripheral Densities,” in the 
A Series System Software Support Reference Manual) 


File name identifier (for the first file on the tape volume). The first byte of 
the name is a binary number that counts characters in the name that 
follows. 


if the tape is a scratch tape that belongs to a scratch pool, these words 
contain the scratch poo! name in EBCDIC characters. The first byte is a 
binary count of the number of characters in the scratch pool name. 


__ If the tape does not belong to a scratch pool, these words contain zeros. 


continued 
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Programming Considerations (cont.) 


Table 3-5. Major Type 15-Minor Types 1 through 5, 12, and 13 (cont.) 


Minor Type = 1 Volume Online (LOGVOLON) 
Minor Type = 2 Volume Offline (LOGVOLOFF) 

Minor Type = 3 Tape Volume Purged (LOGVOLPG) 

Minor Type = 4 Tape Volume Expired (LOGVOLEXP) 
Minor Type = 5. Tape Volume NEWFILE (LOGVOLNEW) 
Minor Type = 12 Tape Volume Used File (LOGVOLUSED) 
Minor Type = 13 Tape Volume Hold (LOGVOLHOLD) 


Words Description 
25-end Variable-length data pointed to by the LINKs in this entry 


Major Type 26: Tape Library Entry (LOGMAJ_MEDIALIB) 


3-74 


Major Type 26 (Tape Library Entry) has been added to document log entries for media 
libraries. This entry is relevant only to RoboHost A users. Refer to the A Series 
RoboHost A Operations, Installation, and Administration Guide for a description of the 
entry format. 
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Section 4 
DMSII Considerations 


This section describes how tape management enhancements affect DMSII utilities. 
Unless otherwise stated, the section references in the following text refer to the DMSII 
manual under which the reference is located. The following manuals are affected: 

e@ A Series DMSII Technical Overview 

@ <A Series DMSIT DASDL Reference Manual 

e@ A Series DMSII Utilities Operations Guide 

Table 4-1 summarizes DMSII information affected by the tape management 


enhancements. DMSII information that is not described in the table remains 
unchanged. 


Table 4-1. Tape Management Enhancements to DMSII 


DMSIi Manual 
Change Affected Topics Affected 


Recommendations DMSII Technical Recommendations for maintaining a 
for dumps Overview dump tape directory 


DMSII Utilities Dump recommendations 
Operations Guide 


SCRATCHPOOL file DMSII Utilities Table of contents information for the 

attribute for tape Operations Guide control file, UPDATE option explanation 

files for the DMCONTROL statement, dump 
tape syntax for the DUMP statement, tape 
medium syntax for the COPYAUDIT 
commands, and syntax for the VISIBLE 
DBS utility 


For more information on the SCRATCHPOOL file attribute, see Section 3, 
“Programming Considerations” of this guide. 


Tape Management Enhancements in the Technical 
Overview 


The tape management enhancements affect how a dump directory is maintained as 
described in the DMSII Technical Overview. 


The following text is added to “Backing Up a Database” in Section 6, “Restoring a 
DMSII Database.” 
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Tapes can have the same name but must have unique serial numbers. When retrieving 
tapes for input, the Cartridge Tape Library (CTL) needs this serial number to mount 
the correct tape on a Cartridge Library Unit (CLU) device. Use one of the following 
techniques to provide this number: 


@ Define a serial number in DMSII. 
@ Use the DMDUMPDIR utility of DMSII. 
@ Use a Tape Management System (TMS) on your site that can provide a serial 


number. 


If you do not use any of these techniques, the system can accept an incorrect tape with 
the same name as the correct one or suspend the task as it waits for an operator 
response. 


For more information on CTL and CLU, see the A Series RoboHost A Programming 
Guide. 


Tape Management Enhancements in DMSII Utilities 


The tape management enhancements affect DMSII utilities and tape files through 
the SCRATCHPOOL file attribute, additional dump recommendations, and the 
SCRATCHPOOL command. The SCRATCHPOOL file attribute is further described 
under “DMUTILITY DUMP Statement” later in this section of the guide. 


Table of Contents 


The scratch pool name is added to the description of audit control information in the 
table of contents. The following text is changed in Section 2, “Control File.” : 


Audit Control 


Audit control information includes the current audit file number, the current audit 
block serial number, and the limits and current values for the primary and secondary 
audit tape serial numbers (when auditing to designated serial numbers) or designated 
scratch pool, if specified. 


DMCONTROL Statement 


The scratch pool name is also transferred when you create a control file from an existing 
one. The syntax explanation for the UPDATE option is changed under “Initializing 
and Maintaining the Control File” in Section 5, “Initializing and Maintaining.” 
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Option Explanation 


UPDATE Causes a new control file to be created from the existing control file 
and the new DASDL description file after a DASDL update run. 


The DASDL update level must be greater than 1. The update level 
in the old control file must be no more than one update Jevel jess 
than that in the database description file. If the old control file 
format level is greater than the current level, an error results. If the 
old control file format level is less than the current format level, it is 
still accepted. The new control file has the update level of the 
database description file, and the current control file format level. 


If REORGANIZATION is in progress, the control file program 
terminates with an error; otherwise, the state flags are transferred 
from the old control file to the new control file. 


The dynamic database parameters are transferred from the new 
database description file. The ranges for audit to designated serial 
numbers are also transferred from the description file. The dynamic. 
audit information is transferred from the old control file. If the 
current tape serial number is not within the new range of 
designated serial numbers, it is changed to the start of the new 
range. Deleted structures are dropped out of the control file. 
Partitioned records relating to a deleted partitioned structure are 
marked as being deleted within the control file. Added structures 
are marked as INITIALIZATION REQUIRED. 


The scratch pool name for the audit tape is also transferred. 


For a reorganized structure, REORGANIZATION alters the creation 
timestamp when it reorganizes the structure. In addition, 
REORGANIZATION alters the format timestamp appropriately if it 
changes the format of the structure. Because partitions cannot be 
reorganized, the partition records section of the control file remains 
unaltered. If the family change bit is 1, the family specifications. in 
the new control file remain as they were in the old control file. 


DMUTILITY DUMP Statement 


The SCRATCHPOOL file attribute is added as an option to the syntax diagram and 
text for dump media under “Dumping a Database” in Section 6, “Backing Up the 
Database.” 
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<dump tape> 


——<tape name > 


> 
/ eo ee a ea 
( /1\- TAPES — = —<integer ) ; 


/1\4~<SERTALNO spec 
SCRATCHPOOL — = <scratch pool name> 
/1\— DENSITY — = BPI208 
BP1556 
BPI899 
BP11259 
BP11699 
BP16259 
BPI11999 
BPI38898 


<serialno spec> 


—— SERIALNO bs aay eran ae = inteje 
( <integer> ) <string6 


The following text is added to the syntax explanation for the <serialno spec>. 


Option Explanation 


<serialno spec> Tapes can have the same name but must have unique serial 
numbers. When retrieving tapes for input, the Cartridge Tape 
Library (CTL) needs this serial number to mount the correct tape on 
a Cartridge Library Unit (CLU) device. Use one of the following 
techniques to provide this number: 


@ Define a serial number in DMSII. 
@ Use the DMDUMPDIR utility of DMSII. 


@ Use a Tape Management System (TMS) on your site that can 
provide a serial number. 


If you do not use any of these techniques, the system can accept an 
incorrect tape with the same name as the correct one or suspend 
the task as it waits for an operator response. 


For more information on CTL and CLU, see the A Series 
RoboHost A Programming Guide. 


The following table explains the syntax construct added because of tape management 


enhancements: 
Option : Explanation 
SCRATCHPOOL Designates the name of the scratch pool from which the tape is 
retrieved. The <scratch pool name> construct is a 17-character 
identifier. 
COPYAU DIT Commands 


The SCRATCHPOOL file attribute is added as an option to the syntax diagram and 
text of tape medium for the COPY command in Section 9, “Copying ane Printing Audit 
Files.” 
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<copy command> 


— COPY —<audit file name>—<audit range : > 

5 AS ais PRIMARY — 
SECONDARY 
>— FROM <medium> TO <medium> > 
Ls CHECK a 

REMOVE 

> 

L COPIES = 1 ; L FORWARD COMPARE a) 
Te 2 . 


<quickcopy command> 


— QUICKCOPY —<audit file name>—<audit range > 
B AS a PRIMARY — 
SECONDARY 


>— FROM <disk medium> TO <tape medium> > 
L CHECK 2 
REMOVE 
>. 
5 COPIES = 1 4 L FORWARD COMPARE J 
i? > 


<verify command> 


— VERIFY —<audit file name>— ON —<medi unm>——H —_———_—__} 


<audit file name> 
: <database name>/ AUDIT<integer> ——— 
Es L> J : 
( <usercode> ) 


<audit range> 


ALL 
| OVERRIDE 
<audit block serial number>—<audit block serial number 


<audit block serial number> 


sae he Rar a | 

( <hex integer> ) . . 

<medium> | 

rey tape ae aaa aa aE 
<disk medium 


<disk medium> 


a i DISK 
PACK See 
= <family name> 
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<tape medium> 


TAPE 
<audit tape density> 


TAPE7 
TAPES 
PETAPE 
TAPEPE 
GCRTAPE 
TAPEGCR 


> 
a SCRATCHPOOL — = —<scratch pool vanes! 


<audit tape density> 


— ( — DENSITY = BPI298 ) --——-—__—-— 
BPI556 


BPI820 
BPI1250 
BPI1620 
BP16250 
BPI11900 
BPI38020 


The following table explains the syntax construct added because of tape management 


enhancements: 
Option Explanation 
SCRATCHPOOL Used only with the COPY and QUICKCOPY commands. This option 


restricts output to a tape from the specified scratch pool. The 
<scratch pool name> construct is a 17-character identifier. 


VISIBLE DBS Commands 


The SCRATCHPOOL file attribute is added as a command to the syntax diagram and 
text of the VISIBLE DBS utility in Section 11, “Communicating with the Database.” 


<visible dbs command> 


<mix status command 


AUDIT SCRATCHPOOL Command 


The AUDIT SCRATCHPOOL command identifies the name of the scratch pool from 
which a tape is selected. 
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AUDIT SCRATCHPOOL command 


— AUDIT SCRATCHPOOL > 
PRIMARY AUDIT 
SECONDARY ALTERNATE 
COPY 


> 
= —<scratch pool name 
RESET 


The AUDIT SCRATCHPOOL command without any options displays information 
about the scratch pool such as its name. 


Option | Explanation 


PRIMARY or SECONDARY Designates that the scratch pool tape is selected for the 
primary or secondary audit, alternate, or copy. 


AUDIT, ALTERNATE, or COPY Designates that the scratch pool tape is selected for the 
audit file, alternate audit file, or audit file copy. 


If none of these options are designated, the scratch pool 
name is assigned to all audit files even if a scratch pool 
name was previously defined for a particular audit file. For 
example, if the following command previously defined the 
scratch pool name for primary audits to XTEST: 


AUDIT SCRATCHPOOL PRIMARY = XTEST 


' Then the following command would define the scratch pool 
names to YTEST, including the primary audits previously 
defined to XTEST: 


AUDIT SCRATCHPOOL = YTEST 


<scratch pool name> A 17-character identifier that names the scratch pool form 
which a tape is selected. 


RESET Designates no scratch pool attribute. If a scratch pool name 
was previously assigned, that name is deleted. 
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Section 5 
TAPEMANAGER Library Implementation 


A tape management system (TMS) is any application that is designed to record or 
control the use of tapes on a system. The A Series operating system now provides 
additional MCP support for some functions of a TMS. To take advantage of this 
support, you must implement these TMS functions as a support library with the 
function name TAPEMANAGER. You must include certain standard procedure 
declarations in the TAPEMANAGER library, but you supply the code for these 
procedures. The MCP calls these procedures whenever certain tape-open requests or 
tape-purge requests occur, and the TAPEMANAGER alae has the opportunity to 
permit, deny, or modify the actions. 


A Series systems do not require a TAPEMANAGER library. However, you might want 
to develop and install a TAPEMANAGER library because it can control the use of 
tapes. A TAPEMANAGER library receives the following information about tape-open 
and tape-purge requests: 


@ The file name and other file attributes of any tape file that is being opened or closed 
e@ The serial number and label of any tape volume that is being purged 

The role of the TAPEMANAGER library is to control tape file and volume access and 
usage through these tape-open and tape-purge requests. A tape management system 
can also track and record current events and the status of tapes in a database, and 


initiate actions through requests and responses to and from the A Series operating 
system. 


Figure 5-1 illustrates the interaction of a TMS in an A Series operating system 
environment. 
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A Series Host 


Any . 
Tape Management 
Utility . 


Any . 
Application 


Operating System - 


Programmatic Interface 
to TAPEMANAGER 


| Tape Fite-Handier | File.Handler 


TAPEMANAGER 
Library | 


Tape 
Applications 


Physical 


1/0 


Data Path 


Controller [Ps Jape Jape ape Controller 
Drive Drive Drive Drive 


A Series Tape Peripheral Units 


Figure 5-1. The Tape Management System (TMS) Environment 


This section discusses the following topics: 


Overview of the TAPEMANAGER library “TAPEMANAGER Functions for TMS Design” 
functions 


Information sources outside the “Event and Status Information Retrieval for 
TAPEMANAGER library TMS Design” 


Overall issues to consider when you “General Considerations for TAPEMANAGER 
implement a TAPEMANAGER library Libraries” 


continued — 
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continued 


Security issues related to TAPEMANAGER “Security Considerations” 
libraries 


The circumstances that cause the MCP to “Interaction with the MCP” 
call various TAPEMANAGER procedures, and 
details about their interaction 


The declarations and parameter descriptions “Exported TAPEMANAGER Procedures” 
for TAPEMANAGER procedures 


Procedures exported by the MCP that are “Exported MCP Procedures for Tape 
related to tape management Management” 


The procedures system operators use to “Operations Interface to the TAPEMANAGER 
install, initiate, and terminate the Library” 
TAPEMANAGER library 


TAPEMANAGER Functions for TMS Design 


The MCP supports six functions as entry points that the TAPEMANAGER library can 
include to aid in the design and implementation of tape management systems (TMSs). 
These functions can help record or control the use of tapes on the system for the 
following tasks: 


@ Opening tape files 


e Purging tape volumes 
e Handling programmatic calls to the TAPEMANAGER library 


Opening a Tape File 


When a process attempts to open a tape file and the TAPEMANAGER library is 
running, the TAPEMANAGER library might call any of three functions: 


¢ CHECK TAPE ASSIGNMENT 


This function determines whether the process is permitted to open a requested 
tape file when the file is not assigned to a tape volume, and the UNITNO file 
attribute is not assigned a tape unit number. CHECK_TAPE ASSIGNMENT can 
inspect the file attribute and task attribute parameter values, and modify certain 
file attributes. The procedure must return an indication of whether the tape 
volume assignment is allowed or denied. 


e CHECK TAPE UNIT ASSIGNMENT 


This function determines whether the process is permitted to open a requested 
tape file when the open request specifies a tape unit number. 
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e@ CHECK TAPE REOPEN 


This function determines whether the process is permitted to reopen a requested 
tape file that is already assigned to a tape volume. 


Purging a Tape Volume 


When a process attempts to purge a tape volume and the TAPEMANAGER library » 
is running, the TAPEMANAGER library calls the CHECK_TAPE_PURGE function. 
This function determines whether the process is permitted to purge the tape. 


Handling Programmatic Calls 


When a process calls the CALL_TAPEMANAGER exported MCP procedure and 
the TAPEMANAGER library is running, CALL_TAPEMANAGER in turn calls the 
PROGRAM_INTERFACE function in the TAPEMANAGER library. This interface 
enables application programs to communicate with the TAPEMANAGER library. It 
also provides a method for a TMS that includes additional programs to enable those 
programs to communicate with the TAPEMANAGER library. 


The MCP calls the CONTROL_INTERFACE function to initiate and to terminate the 
TAPEMANAGER library. An operator can use the system commands SEND TM 
START and SEND TM QUIT to start up and shut down the TAPEMANAGER library. 


For details about the interaction between the MCP and the TAPEMANAGER library, 
refer to “Interaction with the MCP” later in this section. For details about each 
TAPEMANAGER procedure, refer to “Exported TAPEMANAGER Procedures” later in 
this section. 


Event and Status Information Retrieval for TMS Design 


5-4 


The MCP interface to TAPEMANAGER is just one of the features provided by the 
A Series operating system that can help you design and implement tape management 
systems (TMSs). 


The TAPEMANAGER library designates and restricts tape usage based on file 
assignment, reopen, and purge requests. The TAPEMANAGER interface is particularly 
suited to enforcing restrictions on tape usage. TAPEMANAGER can enforce 

such limits effectively because the MCP asks the permission of TAPEMANAGER 
before it opens any tape file or purges any tape. However, TAPEMANAGER is less 
suited to monitoring or recording successful tape actions, because the MCP notifies 
TAPEMANAGER of requested actions rather than successfully completed actions. 


All A Series systems automatically track the status and activity of their peripheral 
units, and allow programs to initiate certain system actions. You can retrieve this 
event and status information to monitor current tape ueeee throughout the system, 
and initiate control actions as needed. 
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The following system features can play a role in the design of a TMS: 


e Event reports in the system log 

e ‘Tape label creation events 

e Status reports about tapes 

e Programmatic initiation of tape operations 

A complete TMS might include multiple programs that make use of these features for 


a variety of purposes. The following information describes the features briefly, with 
notes on how they might be used ina TMS. 


Monitoring Tape Usage Events 


The system log (SUMLOG) maintains a log entry for each system event that affects a 
task, file, unit, or volume. One way for a TMS to monitor successful tape actions is 

by calling the exported MCP procedure REPORT _LOG_ENTRIES. This procedure 
requests the MCP to forward copies of selected types of log entries to a DCALGOL 
queue whenever those entries are logged. Table 5-1 lists the log entry types relevant to 
tape management. 


Table 5-1. Log Entries for Tape Management 


Major Type Minor Type Event Type 
BOJ + Task 

EOJ t Task 

BOT + Task 

EOT t | Task 

File open * File and task 
File close * File and task 
IOP I/O error + Unit and task 
1/O exception f Unit and task 
CLU hardware report ¢ TAPESERVER 


1 
1 
ft 
i 
1 
1 
2 
2 
2 


Volume status * Volume 
Tape library + TAPESERVER 


wp ee 
Hn o 


Legend 

* Documented in Section 3, "Programming Considerations" 

t Documented in the A Series System Software Support Reference Manual 

~ Documented in the A Series RoboHost A Operations, Installation, and 
Administration Guide 
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Note that each of these log entry types is relevant to tape management only part of the | 
time. For example, a File Open entry might record that a tape file is open, or it might 
_ record that a different kind of file is open. 


A TMS is concerned with both tape files and tape volumes. One subtype of a volume 
status entry reports when a volume is labeled. A file open entry reports when a file is 
written to a specific volume. After a task finishes, the volume might be taken offline. 
The volume could be purged, which would be reported as a volume status change. A 
TMS can direct a file to be written to a specific physical volume as a control measure. 


For a description of REPORT_LOG_ENTRIES and documentation of log entry formats, 
refer to the A Series System Software Support Reference Manual. 


Another way a TMS can obtain information about tape events is by calling the exported 
MCP procedure STATUS _CHANGE_REQUEST to monitor tape label creation. This 
procedure requests the MCP to write information about selected types of system events 
to a DCALGOL queue whenever those events occur. Tape label creation is the only tape 
management event that is reported; it is specified to STATUS_CHANGE REQUEST as 
event type 7. For a description of STATUS_CHANGE_REQUEST, refer to the A Series 
System Software Support Reference Manual. 


If you design a TMS to monitor tape activity with REPORT _LOG_ENTRIES and 
STATUS_CHANGE_ REQUEST calls, you might want to place these calls in a process 
that runs independently from the TAPEMANAGER library. This technique can be 
desirable because TAPEMANAGER is subject to termination and restart by the 
operator, and so might not be able to monitor tape activity continuously. 


Monitoring Current Tape Status 


A TMS can use the DCALGOL GETSTATUS function to obtain information about 
the status of tape units on the system. The GETSTATUS type 5 call (Unit Requests) 
can return information for tapes, including the CYCLE, DENSITY, SAVEFACTOR, 
SERIALNO, and VERSION attributes. Also, the type 5 call can return the file name 
and mix number of the process assigned to the tape unit. For more information, refer 
to the A Series GETSTATUS/SETSTATUS Programming Reference Manual. 


A TMS can also use the DCALGOL SYSTEMSTATUS function to determine the 
number and type of tape units available on the system. The Type 13, 21, and 22 
SYSTEMSTATUS calls return a unit information word that includes the tape subtype 
and density for all tape units. The Type 21 call also includes information on tape 

file attributes such as CREATIONDATE, CYCLE, GENERATION, SAVEFACTOR, 
SERIALNO, and VERSION. For further information, refer to the A Series 
SYSTEMSTATUS Programming Reference Manual. 


Initiating Programmatic Tape Operations 
A TMS can use the DCALGOL SETSTATUS function to hold, rewind, or purge tape 


units, and to assign serial numbers to tape volumes. Refer to “SETSTATUS Changes” 
in Section 3 for complete details. 
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The DCALGOL DCKEYIN statement enables a program to pass a request for a system 
command or job to the operating system and receive a response. As an alternative to 
SETSTATUS, a TMS can use DCKEYIN to initiate tape operations such as holding, 
rewinding, or purging tape units through system commands. 


Note: The system response toa SETSTATUS request is encoded so that a 
program can interpret the data. The system response toa DCKEYIN 
request is alphanumeric text designed so that a system operator can 
interpret it. 


CALL_TAPEMANAGER Procedure 


If a TMS includes multiple programs, these programs can communicate 

with the TAPEMANAGER library by using the MCP exported procedure 
CALL_TAPEMANAGER. This procedure could also serve as an interface between 
TAPEMANAGER and any application program that uses tapes. For further 
information about this procedure, refer to “CALL_TAPEMANAGER’” later in this 
section. 


General Considerations for TAPEMANAGER Libraries 


Because the TAPEMANAGER procedures require features, such as file parameters 
and return values, that are not available in most programming languages, you 

can use only ALGOL, BDMSALGOL, DCALGOL, DMALGOL, and NEWP for the 
procedures exported by the TAPEMANAGER library. However, you could use the 
Binder to bind procedures written in these languages into a library program written in 
another language. For information about using the Binder, refer to the A Series Binder 
Programming Reference Manual. 


Only one TAPEMANAGER library can be installed on the system at a time. The 
TAPEMANAGER library must be associated with the function name TAPEMANAGER, 
as described under “Installing the TAPEMANAGER Library” later in this section. 


TAPEMANAGER should be a SHAREDBYALL library to ensure that all user 
processes share the same instance of the library. The freeze should typically be of type 
TEMPORARY. If you use a CONTROL or PERMANENT freeze, the library or the 
system operator must take extra steps to cause the SEND TM QUIT system command 
to have the desired effect. Refer to “Shutting Down” later in this section. 


An operator can terminate the TAPEMANAGER library at any time with the SEND 
‘TM QUIT form of the SEND (Send Message) system command. Any information the 
TAPEMANAGER library stores in memory is lost when TAPEMANAGER terminates. 
Therefore, any information of permanent value that is passed to a TAPEMANAGER 
procedure should be written to some permanent storage medium before the procedure 
exits. 


Unisys recommends that you use the MP (Mark Program) system command to mark as 
private and assign an identity to the TAPEMANAGER library object code file. This 
identity appears in any system messages or display messages generated by a process 
that is executing TAPEMANAGER code. 
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You might want to avoid the use of statements that enter into transaction state in 
TAPEMANAGER exported procedures. Transaction state is normally invoked by 
processes before they attempt to update records in a Data Management System II 
(DMSII), Semantic Information Manager (SIM), or Structured Query Language 
Database (SQLDB) database. 


Problems can arise because TAPEMANAGER exported procedures execute on user 
process stacks, and any of these user processes might already have a database open and 
in transaction state. It would be unusual for a process to attempt to open a tape while 


- the process is in transaction state against a database, because database transactions 


are usually time-critical. However, if such a user process is already in transaction state, 
and the TAPEMANAGER exported procedure itself enters transaction state, the user 
process encounters an error. If the user process does not handle the error itself, the 
user process becomes suspended as described under “Error Handling by the MCP” 
later in this section. 


If TAPEMANAGER exported procedures simply read database records, rather than 
updating them, then the procedures do not need to enter into transaction state. 
However, even in this case problems can arise if TAPEMANAGER is a SHAREDBYALL 
library (which it typically is) and the database is declared globally to the exported 
procedures. A variety of undefined results can occur if two or more user processes of 
this library have transactions in progress against the database at the same time. 


For example, if two user processes are executing FIND NEXT statements at the same 
time without locks, each user process is likely to get every other record. Therefore, if 
the TAPEMANAGER exported procedures access a database, the library should use 
events to ensure that only one user process can have a transaction in progress against 
the database at a time. 


Any TAPEMANAGER exported procedure that procures globally-declared events 
should include an EXCEPTION procedure to liberate these events if the user process 
terminates abnormally. Without the EXCEPTION procedure, the MCP cannot perform 
cleanup processing after an abnormal exit from a TAPEMANAGER procedure. 
EXCEPTION procedures are available in DCALGOL, DMALGOL, and NEWP. 


For more information about using libraries on A Series systems, refer to the A Series 
Task Management Programming Guide. 


TAPEMANAGER Error Handling 


When a user process opens or purges a tape file, the MCP invokes one or more 
TAPEMANAGER procedures that execute on the user process stack. Thus, the MCP 
considers any errors in TAPEMANAGER procedures to be errors committed by 

the user process. However, the MCP takes special steps to ensure that it does not 
discontinue processes that use tapes because of errors in the TAPEMANAGER code. 
Additionally, you can design TAPEMANAGER to handle certain types of errors on its 
own. . 
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Fault Handling within TAPEMANAGER 


Faults are those program errors that receive a HISTORYCAUSE task attribute value of 
4 (FAULTCAUSEYV) and that normally cause the process to be discontinued with the 
F-DS message. In any TAPEMANAGER exported procedure that you write in ALGOL, 
you can include an ON statement to specify special handling for any faults committed 
by that procedure. For example, the ON statement could modify the procedure result 
to indicate whether the requested action is to be allowed or denied (whichever is the - 
preferred default at your site). 


Note: If TAPEMANAGER handles faults with an ON statement, then 
TAPEMANAGER should also provide reasonable diagnostic features 
to enable support personnel to determine which fault occurred, and 
why. For example, TAPEMANAGER could display a message 
describing the fault, or could provide an option that enables operators 
to request a program dump. 


Error Handling by the MCP 


While a user process is executing TAPEMANAGER code, the only cause that can 
discontinue the user process is a DS (Discontinue) system command. The MCP 
protects the user process from any faults that are not handled by ON statements in 
TAPEMANAGER, as well as from all other types of program errors. If any fault or 

_ error occurs that would normally terminate the user process, the MCP takes the 
following actions: 


1. Issues display messages that show the current values of the HISTORYTYPE, 
HISTORYCAUSE, HISTORYREASON, and STOPPOINT task attributes of the 
user process. These messages appear in the MSG (Display Messages) system 
command output, and are also written to the system log as Major Type 3, Minor 
Type 7 (Display Message) entries. You can use these values to help debug the 
TAPEMANAGER library. 


2. Resets the HISTORY, HISTORYTYPE, HISTORYCAUSE, and HISTORYREASON 
task attributes of the user process to zero. 


3. Suspends the user process and displays an RSVP request, system message 
’ MSRMISC221: “USER PROCESS FAULTED OR DSED WHILE IN 
TAPEMANAGER LIBRARY CODE.” 


The following table shows the possible operator responses to this RSVP request and 


the effects of these responses: 
/ 


Response . Effect — 
OK The MCP invokes the same library procedure again. 
DS The MCP discontinues the user process. 


continued 
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continued 
Response Effect 
OF | The open or purge request continues as if the TAPEMANAGER library were 


not installed. 


Because TAPEMANAGER might be used to enforce tape security at some 
sites, the MCP limits the use of the OF response. The OF response can be 
submitted from the following sources: 


@ Operator display terminals (ODTs) 


@ Remote ODTs; that is, remote terminals granted ODT status by the 
REMOTESPO (Activate REMOTESPO) system command 


@ Nonusercoded Menu-Assisted Resource Control (MARC) sessions 
@ DCKEYIN functions in nonusercoded DCALGOL processes 


The MCP ignores the OF response if it is submitted from CANDE sessions, 
usercoded MARC sessions, or usercoded DCALGOL processes. 


If the TAPEMANAGER library is discontinued by a DS command, then the MCP also 
protects any user processes linked to the library and suspends them with the “USER 
PROCESS FAULTED OR DSED WHILE IN TAPEMANAGER LIBRARY CODE” 
message. If the TAPEMANAGER library is discontinued with the SEND TM QUIT 
form of the SEND (Send Message) system command, any user processes linked to the 
library continue processing, and the library terminates only after all user processes 
have exited the TAPEMANAGER procedures. 


If the user process was initiated by a job, and you use the DS command to discontinue 
that job, the MCP suspends the user process with the “USER PROCESS FAULTED 
OR DSED WHILE IN TAPEMANAGER LIBRARY CODE” message described 
previously. The job remains in the A (Active Entries) mix display, but the MCP has 
already set the history task attributes of the job as follows: HISTORYTYPE = 4 
(DSEDV), HISTORYCAUSE = 1 (OPERATORCAUSEV), and HISTORYREASON = 2 
(JUSTDSEDV). The job actually terminates only when the user process terminates. 


Security Considerations 
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The MCP sets the following Boolean library attributes to TRUE for the 
TAPEMANAGER function name: 


e MCPINIT. This attribute ensures that only the MCP can initiate the library by way 
of the TAPEMANAGER function name. 


e ONEONLY. This attribute ensures that only one version of the library code file 
can be active at a time. In other words, the old version of the library must 
be terminated before a new version can be initiated. Refer to “Replacing the 
- TAPEMANAGER Library with a Newer Version” later in this section. 


After the MCP initiates the library, the library linkage class determines which user 
processes are allowed to link to the library. The MCP associates a linkage class of 1 
with the TAPEMANAGER library function name. This linkage class ensures that only 
the MCP and selected system libraries can link to the library by using a LIBACCESS 
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value of BYFUNCTION. Furthermore, after the MCP links to the TAPEMANAGER 
library, the MCP also prevents other processes from linking to the library BYTITLE. 
For a discussion of library linkage classes, refer to the Task Management Programming 
Guide. 


It is possible for any process to link to the library by using a LIBACCESS value of 
BYTITLE, if the process makes the linkage before the MCP does. To prevent such 
unauthorized accesses, you can assign the library code file a SECURITYTYPE file 
attribute of PRIVATE. Even when this file attribute is set, privileged user processes or 
user processes with the same usercode as the TAPEMANAGER code file can link to the 
library BYTITLE. 


Note: Normally the MCP should be the only user linked to the 
TAPEMANAGER library. If other user processes are linked to the 
library, the SEND TM QUIT form of the SEND (Send Message) 
system command cannot successfully cause the library to terminate. 


For further information about TAPEMANAGER nbrery initialization, refer to 
“Starting Up” later in this section. 


Interaction with the MCP 


The MCP calls TAPEMANAGER exported procedures in response to a number of types 
of events that involve tape activity. The following pages discuss the situations that 
result in such procedure calls, and the types of interaction that can take place in each 
of these situations. For detailed descriptions of the various exported TAPEMANAGER 
procedures, refer to “Exported TAPEMANAGER Procedures” later in this section. 


TAPEMANAGER Library Start Up and Shut Down 


Figure 5-2 shows the status changes of the TAPEMANAGER library during start up 
and shut down. In this figure, the following conventions apply: 


e The elliptical boxes contain the TAPEMANAGER library status value, which 
changes from INACTIVE to ACTIVE at start up, and from ACTIVE to INACTIVE 
at shut down. 


e The command or event that causes a status change is specified between the two 
boxes. 


e The action taken as a result of the status change is enclosed in square brackets. 
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INACTIVE 


Operator enters 
SEND TM START or 
system halt loads 
with TM option set. 


MCP intiates 
TAPEMANAGER INITIALIZATION 
(TMI). 


LINKING 


Link to TM fails 
or CONTROL INTERFACE 
does not exist in TM. 


T™ terminates. 


GO INGAWAY 


™ completes all calls 
in progress. 


[TMT or TMI terminates. ] 


WAITING TO DELINK 


CONTROL INTERFACE exits. 


™ library freezes. 


TI calls 
CONTROL INTERFACE 


with start request. 


INITIALIZING — 


CONTROL INTERFACE 
fails. 


CONTROL INTERFACE 
exits. ) 


TMI terminates. 
MCP resumes suspended 


tasks requiring TM. 


TERMINATING 


Operator enters 
SEND TM QUIT. 


MCP initiates 
TAPEMANAGER TERMINATION 
(TMT). TMT calls 
CONTROL INTERFACE 

with stop request. 


; ACTIVE 


Figure 5-2. TAPEMANAGER Library Status Change Diagram 


Starting Up 
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When the MCP starts up the TAPEMANAGER library, its state changes from inactive 
to active. The MCP suspends any task that calls TAPEMANAGER until the library 
becomes active. 


Before you can initiate the TAPEMANAGER library, you must do the following: 


e Define the TAPEMANAGER function name with the SL (Support Library) system 
command. 


@ Set the TAPEMANAGER system option with the SYSOPS (System Options) 
system command. 
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Initiating TAPEMANAGER 


To initiate TAPEMANAGER, either send a SEND TM START system command 
or perform a system halt/load. In either of these cases, the MCP changes the 
TAPEMANAGER status from INACTIVE to LINKING. Refer to “Inspecting the 
TAPEMANAGER Status” later in this section. The MCP then initiates the visible 
independent runner TAPEMANAGER INITIALIZATION to initiate the library. 


Linking to the TAPEMANAGER Library 


TAPEMANAGER INITIALIZATION attempts to link to the TAPEMANAGER library 
with the LINKLIBRARY function. Library linkage can fail if the TAPEMANAGER 
function is not defined, if the library code file is missing or is not a library, and so 

on. If library linkage fails, TAPEMANAGER INITIALIZATION becomes suspended 
with the RSVP request, system message MSRMISC204: “UNABLE TO LINK 

TO TAPEMANAGER. ENTER OK TO RETRY.” After you attempt to remedy 

the situation, for example by copying a corrected version of the library to its 
intended location, you can enter an OK (Reactivate) system command to cause 
TAPEMANAGER INITIALIZATION to retry the linkage. 


If the linkage does not immediately fail, the MCP initiates the TAPEMANAGER 
library code file. Before TAPEMANAGER executes a FREEZE statement, it can 
perform preparatory functions such as opening a database. 


Verifying TAPEMANAGER Procedures 


When TAPEMANAGER freezes, the MCP determines whether the standard 
TAPEMANAGER procedures are exported by the library. These procedures are 
described under “Exported TAPEMANAGER Procedures” later in this section. If 
one or more of these procedures are missing, the MCP displays the system warning 
message MSRMISC209: “WARNING: TAPEMANAGER LIBRARY IS MISSING ONE 
OR MORE OBJECTS.” . 


If the CONTROL_INTERFACE procedure is missing, the MCP displays the following 
additional system messages MSRMISC210 and MSRMISC208: 


TAPEMANAGER LIBRARY IS MISSING CONTROL_INTERFACE PROCEDURE 
TAPEMANAGER LIBRARY WILL: NOT BE USED 


If CONTROL _INTERFACE is missing, the MCP does not use the TAPEMANAGER 
library. If CONTROL_INTERFACE is present, but other procedures are 

missing, the MCP uses only the procedures that are present. For example, if the 
CHECK TAPE PURGE procedure is missing, the MCP does not consult the 
TAPEMANAGER library when purge requests occur. 


When the library freezes, the MCP changes the TAPEMANAGER status 

to INITIALIZING, and TAPEMANAGER INITIALIZATION calls the 
CONTROL _ INTERFACE library procedure with a start request. The 
CONTROL_INTERFACE procedure can perform initialization functions that are 
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specific to the TAPEMANAGER implementation, such as opening a database if it has 
not already done so. 


Completing Initialization 


When CONTROL_INTERFACE exits, the TAPEMANAGER status changes to ACTIVE 
and the TAPEMANAGER INITIALIZATION independent runner terminates. At this 


point, the library is ready for use. When the TAPEMANAGER library is active, the 


MCP allows any task that calls the library to proceed. 


If you enter a SEND TM START command while the TAPEMANAGER status is 
LINKING or INITIALIZING, the system displays the system message MSRMISC222: | 
“TAPEMANAGER LIBRARY IS ALREADY ACTIVE.” 


Shutting Down 
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When the MCP shuts down the TAPEMANAGER library, its state changes from active 
to inactive, as shown in Figure 5-2. When the TAPEMANAGER library is in any state 
other than active, the MCP suspends any task that calls the library. 


When you enter the SEND TM QUIT form of the SEND (Send Message) system 
command, the MCP takes the following actions: 


e Changes the status of the library to TERMINATING. You can display this status, 
as described under “Inspecting the TAPEMANAGER Status” later in this section. 


e Allows any processes that are currently executing TAPEMANAGER procedures to 
continue normally. 


e Suspends any processes that attempt tape actions that would require new calls on 
the TAPEMANAGER library. Refer to “Responding to Processes Waiting on the 
TAPEMANAGER Library” later in this section. 


e Initiates the TAPEMANAGER TERMINATION visible independent runner, which 
in turn invokes the CONTROL_INTERFACE procedure of the TAPEMANAGER 
library with a stop request. If you used the SEND TM QUIT <text> command, 
then the text is passed to the REQUEST parameter of CONTROL_INTERFACE. 
The meaning of this text is determined as the TAPEMANAGER library 
implementation. 


If the library has a CONTROL freeze, the library should exit the control 
procedure when the CONTROL_INTERFACE procedure receives the stop request. 
CONTROL _INTERFACE can notify the control procedure to exit by causing some 
event in the library that is declared global to both procedures. Exiting the control 
procedure changes the library to a TEMPORARY library. 


The TAPEMANAGER TERMINATION process terminates after the 
CONTROL _ INTERFACE procedure returns. The MCP changes the TAPEMANAGER 
status to WAITING TO DELINK. TAPEMANAGER remains in this state until it 
completes all calls currently in process. At this point, the MCP delinks from the library 
and changes the TAPEMANAGER status to GOINGAWAY. 
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The exact effects of the GOINGAWAY assignment vary, depending on the freeze type of 
the library. These varying effects are as follows: 


e Ifthe library freeze is TEMPORARY, then the library unfreezes and resumes 
execution when the MCP sets the TAPEMANAGER status to GOINGAWAY. The 
TAPEMANAGER status remains GOINGAWAY until the TAPEMANAGER 
process terminates. 


e Ifthe library originally had a CONTROL freeze, CONTROL_INTERFACE should 
have already notified the control procedure to exit so the freeze could become 
TEMPORARY. 


e Ifthe library freeze is PERMANENT, it remains frozen until the operator enters 
a THAW (Thaw Frozen Library) system command. The THAW command 
changes the library freeze to TEMPORARY and thus enables it to unfreeze and 
resume execution. The TAPEMANAGER status remains GOINGAWAY until the 
TAPEMANAGER process terminates. 


If you enter a SEND TM START system command while the library status is 
TERMINATING, WAITING TO DELINK, or GOINGAWAY, the MCP delays the 
request until the library has terminated. 


Refer to “Terminating the TAPEMANAGER Library” later in this section for 
information about measures you can take if the library takes longer than expected to 
terminate. 


Opening Files 


When a process attempts to open a tape file and the TAPEMANAGER library is 
installed and running, the MCP might call any of the following procedures in the 
TAPEMANAGER library, depending on the circumstances: 

e CHECK TAPE ASSIGNMENT 

e CHECK TAPE UNIT_ASSIGNMENT 

e CHECK TAPE REOPEN 

The MCP passes information to the TAPEMANAGER procedures in parameters, and 
the TAPEMANAGER procedures return results that either accept, deny, or modify 
the request. If you modify an open request with system commands such as FA (File 


Attribute) or OU (Output Unit), the MCP invokes the TAPEMANAGER procedures 
again to verify that the modified request is acceptable. 


CHECK_TAPE_ASSIGNMENT 


The MCP calls the CHECK_TAPE ASSIGNMENT procedure when the following 
conditions are all true: . 


e A process attempts to open a file with a KIND file attribute value equal to TAPE or 
DONTCARE. Files with KIND equal to DONTCARE can be assigned to tape units. 


@ The file has not already been assigned to a tape volume. 
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e The tape unit number has not been specified. 


The MCP also calls the CHECK_TAPE_ ASSIGNMENT procedure after an initial open 
request for a specific tape unit was denied; the MCP then determines whether the open | 
request can proceed with no tape unit specified. 


The MCP calls CHECK_TAPE_ ASSIGNMENT under two additional circumstances: 


@ Areel switch is handled as an implicit open request. 


e The FA and OK system commands indicate an operator request to proceed with the 
file open request. 


Figure 5-3 illustrates the flow of information between the 
CHECK TAPE ASSIGNMENT procedure and the operating system. 
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Conditions for Entry | 


Initial file open 
UNITNO not specified Implicit open FA or OK 
reel switch system command 


and 
KIND=TAPE or DONTCARE 


CHECK TAPE ASSIGNMENT 


-Interrogate request 
and source parameters. 


-Interrogate file attribute and 
task attribute values. 


-Optionally update certain 
file attributes. 


-Determine MCP action. 


Continue open . Terminate open 
and search for ae Beers process and return 
matching tape ; : open error 


volume. system ‘command . to program. 


* CHECK TAPE ASSIGNMENT or CHECK TAPE UNIT ASSIGNMENT 
' might have been called previously.. 
** CHECK TAPE ASSIGNMENT or CHECK TAPE UNIT ASSIGNMENT 
might be called again. 
*xek Action taken if entry point missing is from TAPEMANAGER. 


Figure 5-3. Information Flow in CHECK_TAPE_ASSIGNMENT 


When a process requests a reel switch, it is attempting a tape I/O operation that 
cannot proceed until the logical file is reassigned to the next volume of a multivolume 
set. For output tapes, a scratch tape can serve as the continuation reel. For input 
tapes, the combination of the FILESECTION file attribute and the SERIALNO file 
attribute identifies the tape that is needed. Before searching for the continuation 
volume, the MCP invokes the CHECK_TAPE_ ASSIGNMENT procedure to determine 
if TAPEMANAGER permits this reel switch. 


If the open request is for a tape file on an unspecified unit, the MCP invokes the 

CHECK_TAPE ASSIGNMENT procedure. The MCP passes various parameters, 
including the file variable of the tape file and the task variable of the process that 
declared the file. 
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CHECK_TAPE ASSIGNMENT can inspect file and task attributes, and can modify 
many of the file attributes. 


The CHECK_TAPE ASSIGNMENT procedure result can specify any of several 
responses to the open request: 


e Ifthe procedure rejects the open request, it returns an open error to the opening 
process. 


e Ifthe procedure accepts the open request, the MCP determines whether the 
requested tape is available. 


e Ifthe procedure returns an OF result, the MCP takes the same action as if an OF 
(Optional File) system command had been entered. The MCP determines whether 
the file that received the OF result was originally declared with the OPTIONAL file 
attribute set to TRUE. 


If OPTIONAL is TRUE, then the MCP permits the open operation to continue. 
However, the first time the process attempts to read from or write to the file, the 
MCP returns an end of file indication. 


If OPTIONAL is FALSE, the MCP returns an open error. 


e Ifthe procedure returns an NF result, the MCP takes the same action as if the 
NF (No File) system command had been entered. The open operation completes, 
and the MCP returns an end-of-file result the first time the process reads from or 

- writes to the file. 


e Ifthe procedure returns an FR result, the MCP takes the same action as if the FR 
(Final Reel) system command had been entered. The open operation completes, 
and the MCP returns an end-of-file result the first time the process reads from or 
writes to the file. 


e Ifthe MCP returns a nontape result, the MCP continues with the open 
operation, but excludes tape units from the search. You might want 
CHECK TAPE ASSIGNMENT to return this response when the file being opened 
has a KIND value of DONTCARE. | 


CHECK _TAPE_UNIT_ASSIGNMENT 
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The MCP calls CHECK_TAPE UNIT_ASSIGNMENT when a process attempts to open 
a tape file (KIND=TAPE) that has not yet been assigned to a tape volume, and the 
UNITNO file attribute has been assigned a tape unit number. 


The MCP also calls this procedure if the file KIND is equal to DONTCARE and the 
UNITNO is a tape unit. 


The MCP calls CHECK_TAPE UNIT_ASSIGNMENT regardless of whether UNITNO 
was assigned by the opening process or by a system command such as IL (Ignore 
Label), OU (Output Unit), or UL (Unlabeled). 


Figure 5-4 illustrates the flow of information between the 


CHECK_TAPE UNIT. ASSIGNMENT procedure and the operating 
system. 
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Conditions for Entry . 


kk 


Operator 
OU,IL or UL 


Initial file open 
UNITNO specifies a 
tape unit 
KIND=TAPE or DONTCARE or 
backup tape request 


Operator FA 
system ‘command 
specifying 
UNITNO 


system ‘command 
specifying 
MT unit 


CHECK TAPE UNIT ASSIGNMENT 
-Interrogate source and 
unit number parameters. 


-Interrogate file attribute and 
task attribute values. 


~Determine MCP action. 


UNITNO 
specified 


Continue open process 
and search for RSVP message pec 


matching tape (waiting entry). 
volume. CHECK TAPE ASSIGNMENT. 


* Action taken if entry point is missing from TAPEMANAGER. 
** CHECK TAPE ASSIGNMENT or CHECK TAPE UNIT ASSIGNMENT 
might have been called previously.. 
*** CHECK TAPE ASSIGNMENT or CHECK TAPE UNIT ASSIGNMENT 


might be called again. 


Figure 5-4. Information Flow in CHECK_TAPE_UNIT_ASSIGNMENT 


If the unit number is that of a nontape unit, the MCP suspends the opening process 
with the RSVP request, system message MSRFOUT23: “<unit identifier> TYPE 
DISAGREES WITH KIND, REQUIRES MT # <unit number>.” The unit type is the 
unit type of the unit with the specified unit number. 


The possible operator responses to the RSVP message are the FA (File Attributes), 
OU (Output Unit), and DS (Discontinue) system commands. 
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If a tape file open request is waiting for an operator response, the operator can 

enter one of the following system commands: IL (Ignore Label), OU (Output 

Unit), or UL (Unlabeled Unit). In those cases, the MCP passes a parameter to 
CHECK_TAPE UNIT _ASSIGNMENT that identifies which of the system commands 
(IL, OU, or UL) assigned the unit number. These commands cause the MCP to attempt 
to open the tape file on the tape unit with the unit number specified in the command. 


The MCP passes CHECK_TAPE UNIT_ASSIGNMENT various parameters, including 
the file variable of the tape file and the task variable of the process that declared the 
- file. 


CHECK_TAPE_UNIT_ASSIGNMENT can inspect task attributes or file attributes. 
Note that this procedure cannot modify file attributes. 


The CHECK TAPE UNIT_ASSIGNMENT procedure result specifies whether the me 
can be opened on the requested tape unit. 


If CHECK_TAPE UNIT_ASSIGNMENT denies an open request that 

specifies UNITNO, then the MCP resets UNITNO and invokes the 
CHECK_TAPE_ ASSIGNMENT procedure, to see if the open operation can proceed 
without a specific unit being requested. 


If the procedure denies an open request that does not specify UNITNO, the process is 
suspended with an operator RSVP system message. 


The MCP determines whether the requested tape is available on the requested unit. If 
the requested tape is available, the MCP continues with the tape file open operation. 
Otherwise, the process opening the tape file becomes suspended. 


CHECK_TAPE_REOPEN 


The MCP calls the CHECK_TAPE REOPEN procedure when a process attempts to 
open a tape file that was previously assigned to a tape volume and was closed with 
retention. 


Figure 5-5 illustrates the flow of information between the CHECK_TAPE REOPEN 
procedure and the operating system. 
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Condition for Entry . 


Open file 
already assigned 
to tape volume 


CHECK TAPE REOPEN . 


-Interrogate unit number 
and file name parameters. 


-Interrogate file attribute 
and task attribute information. 


-Determine MCP action. 


MCP terminates 
open process 
with open error. 


MCP continues 
open process. 


* Action taken if entry point is missing 
from TAPEMANAGER. 


Figure 5-5. Information Flow in CHECK_TAPE REOPEN 


The MCP determines whether the tape file is already assigned toa tape volume. This is 
the case if the tape file was previously opened and then closed with retention. 


If the tape volume is already assigned, the MCP invokes the CHECK_TAPE REOPEN 
procedure of the TAPEMANAGER library. CHECK_TAPE_REOPEN receives various 
parameters, including the file variable of the tape file and the task variable of the 
process that declared the file. 


The CHECK TAPE REOPEN procedure result specifies whether the open can 


proceed. If CHECK | ‘TAPE | REOPEN approves the open request, then the open request 
proceeds. Otherwise, the open request fails. 


Purging Tape Volumes 


Before it executes any purge request, the MCP calls the CHECK TAPE PURGE 
procedure in the TAPEMANAGER library. 


Figure 5-6 illustrates the flow of information between the CHECK_ TAPE PURGE 
procedure and the operating evevem: 
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Conditions for Entry . 


SN or PG 


system © Program close 
command or . with 
SETSTATUS purge option 


call 


¢ 
CHECK TAPE PURGE 


-Interrogate purge 
request information. 


-Optionally modify . 
scratch pool or density. 


-Determine MCP action. 


OK Denied Denied 
(SERIALNO) 


Denied 
(SCRATCHPOOL) 


Continue Abort purge Abort purge Abort purge 


purge (no secific (SERIALNO (SCRATCHPOOL 
process. reason) . rejected). rejected). 


* Action taken if entry point missing from TAPEMANAGER. 


Figure 5-6. Information Flow in CHECK_TAPE_PURGE 


The CHECK_TAPE PURGE procedure receives a SOURCE parameter, which specifies 
whether the purge request resulted from a close with purge or a PG (Purge) or SN 
(Serial Number) system command. The CHECK_TAPE PURGE procedure also 
receives a REQUEST_AND RESPONSE parameter containing most of a Major Type 
15, Minor Type 3 (Tape Volume Purged) log entry. 


The CHECK TAPE PURGE procedure can modify the scratch pool value, the 
density value, or both, in the REQUEST_AND_ RESPONSE procedure. The 
CHECK _TAPE PURGE procedure can also indicate, in its return value, whether the 
purge should be allowed to proceed. 
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Note: By default, the MCP regards a tape volume as expired if the tape 
is mounted with a write ring and today’s date is equal to, or later 
than, the expiration date in the tape label. The MCP treats expired 
tapes like scratch tapes that output files can be assigned to. In 
this way, a tape volume can become a scratch tape without the 
CHECK_TAPE PURGE entry point in TAPEMANAGER ever being. 
invoked. 


A tape-monitoring program can monitor this implicit creation of 
scratch tapes by requesting Major Type 15, Minor Type 4 (Tape 
Volume Expired) log entries through the REPORT_LOG_ENTRIES 
function. For a description of REPORT_LOG_ENTRIES, refer to 
the A Series System Software Support Reference Manual. For a 
description of the Tape Volume Expired log entries, refer to “Logging 
Enhancements” in Section 3, “Programming Considerations.” 
Alternatively, you can prevent the implicit creation of scratch tapes by 
setting the TAPEEXPIRATION option with the SYSOPS (System 
Options) system command. When TAPEEXPIRATION is set, the 
MCP does not treat an expired tape as a scratch tape. 


Handling Programmatic Calls to the TAPEMANAGER Library 


Application programs that use tapes can communicate with the TAPEMANAGER 
library by invoking the CALL_TAPEMANAGER exported MCP procedure, which in 
turn calls the PROGRAM INTERFACE procedure in the TAPEMANAGER library. 
Also, if a TMS includes other programs in addition to the TAPEMANAGER library, 
those programs could use the CALL_TAPEMANAGER procedure to communicate with 


TAPEMANAGER. 


PROGRAM _INTERFACE receives the following two parameters: 


@ CALLER. This parameter indicates whether the calling program is privileged. 


e@ REQUEST_AND_RESPONSE. This parameter is an array whose contents are 


defined by the TAPEMANAGER implementation. 


PROGRAM INTERFACE can return information to the caller either by modifying the 


REQUEST_AND_RESPONSE array, or by modifying the procedure return value. 


Exported TAPEMANAGER Procedures 


The MCP is designed to invoke a particular set of procedures in the TAPEMANAGER 
library, which must have the expected names and the expected parameter types. For an 
overview of the situations that cause the MCP to invoke these procedures and how they 


interact, refer to “Interaction with the MCP” earlier in this section. 


Table 5-2 provides information about these procedures. 
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Table 5-2. Exported TAPEMANAGER Procedures 


Procedure | Optional or Required Purpose 


CHECK_TAPE_ASSIGNMENT Optional Used in file open 
operations 


CHECK_TAPE_UNIT ASSIGNMENT Optional Used in file open 
operations 


CHECK_TAPE_REOPEN Optional Used in file open 
operations 


CHECK_TAPE_PURGE Optional Used in tape volume 
purge operations 


PROGRAM_INTERFACE | Optional Used by 
CALL_TAPEMANAGER 
procedure 


CONTROL_INTERFACE Required Used by MCP to 
initialize library 


Of these procedures, the CONTROL INTERFACE procedure must be present for the 
MCP to consider the library valid. The other procedures are optional and are not 
invoked if they are not present. 


If the PROGRAM_INTERFACE procedure is not present, and a user program 
invokes the CALL_TAPEMANAGER procedure, the user program proceeds normally 
and CALL_TAPEMANAGER returns a procedure result value of 0. Refer to 
“CALL_TAPEMANAGER” and “PROGRAM INTERFACE” later in this section. 


The following pages provide detailed explanations of these procedures. A sample 
TAPEMANAGER library coded in DCALGOL is also provided. The library includes 
sample code for each TAPEMANAGER procedure as well as the exported MCP 
procedures CALL_TAPESERVER and CALL_TAPEMANAGER, described later in this 
section. 
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CHECK_TAPE_ASSIGNMENT 


The MCP calls the CHECK_TAPE ASSIGNMENT procedure in the TAPEMANAGER 
library when a process attempts to open a tape file that is not assigned to a tape 
volume, and the UNITNO file attribute is not assigned a tape unit number. 


The MCP passes parameters to CHECK _TAPE ASSIGNMENT, including the values of 
those file attributes most likely to be of interest, the file variable itself, and the task 
variable of the process opening the file. 


‘The parameters can specify a labeled or unlabeled tape, a backup or non-backup tape, a 
new or existing tape volume, and acceptance of either a nontape file or a tape file only. 


The CANDIDATE FILE is the file variable of the tape file being opened. This parameter 
determines which file attributes can be modified by CHECK_TAPE_ASSIGNMENT to 
affect the current open request. 


Note that the TAPEMANAGER library should not open the CANDIDATE FILE, » 
because an open operation is already underway for that file. If TAPEMANAGER 
attempts to open the file, the open operation fails. The open result or AVAILABLE 
file attribute value is 234. If the opening process does not trap the open error, the 
system discontinues the process and displays system message MSRFIB270: “LIBRARY 
CANNOT OPEN THIS FILE.” j 


CHECK TAPE ASSIGNMENT can inspect the values passed, and modify the file 
attributes of the file variable if desired. The procedure also must return an indication 
of whether the tape volume assignment is to be permitted or denied. 


If this entry point is missing in the TAPEMANAGER library, the result is the same as 
if permission to open the tape file had been granted. 


Compare this procedure with the CHECK_TAPE UNIT_ASSIGNMENT and 
CHECK_TAPE_REOPEN procedures discussed later in this section. 


Syntax 
Specify the procedure heading as follows: 


REAL PROCEDURE CHECK TAPE ASSIGNMENT (SOURCE, 

CANDIDATE _FILE, 
CANDIDATE _FILE_TASK, 
REQUEST AND RESPONSE) ; 

VALUE SOURCE; 

REAL SOURCE; 

FILE CANDIDATE FILE; 

TASK CANDIDATE FILE TASK; 

ARRAY REQUEST AND RESPONSE [9]; 
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Explanation 


The description of the parameters follows. 


SOURCE (Real, input Only) 


The source of the request is laid out as follows: 
Field Value Meaning 


[47: 1] Indicates whether the process opening the file is 
the same as the process declaring the file. The 
task variable of the declaring process is passed in 
the CANDIDATE_TASK parameter. The task 
variable of the opening process can be accessed 
by way of the MYSELF predeclared task variable. 


0 The opening process and the declaring process are 
the same. 
1 The opening process is different from the declaring 
process. 
[46: 1] 0 The request is for a labeled tape. 
1 The request is for an unlabeled tape. 
[45: 1] 0 Only a tape file can satisfy the request. 
1 The request can be satisfied by a tape file or a 
nontape file (for example, a logical file with 
KIND = DONTCARE). 
[44: 1] 0 | The request is not for a backup tape. 
1 The request is for a backup tape. 
[43:36] This field is reserved for future use. 
[7: 8] 1 The request is for a new tape volume. 
2 The request is for an existing tape volume. 


CANDIDATE_FILE (File, Input/Output) 


CANDIDATE. FILE is the file variable of the tape file being opened. The following 
rules determine which file attributes CHECK_TAPE ASSIGNMENT can modify to 
affect the current open request: 


e For tapes that are not library maintenance tapes, CHECK_TAPE_ ASSIGNMENT 
can modify the same file attributes that can be modified by an FA (File Attributes) 
system command. . 


e For files assigned to the first volume of library maintenance tapes, the FA command 
can modify only the SCRATCHPOOL and SERIALNO file attributes. However, 
CHECK TAPE ASSIGNMENT can modify all the following file attributes: 
CYCLE, DENSITY, FILENAME, SAVEFACTOR, SCRATCHPOOL, SERIALNO, 
and VERSION. If FILENAME is modified, the new FILENAME value must end in 
/FILEOOO. 
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e For the second and later volumes of library maintenance tapes, both the FA 
command and CHECK TAPE ASSIGNMENT can modify only the SERIALNO file 
attribute. 


If CHECK_TAPE ASSIGNMENT modifies other file attribute values, the changes do 
not affect the open request that is currently in progress. However, if the same logical 
file is reused in a later open request, the file attribute assignments might affect that 
request. 


If CHECK_TAPE_ ASSIGNMENT does change any file attribute values, this fact is 
noted in Word 7, Field [44: 1] of the Major Type 1, Minor Type 5 (File Open) log entry. 
Changing attributes during the call does not result in another immediate call; only an 
operator FA response does that. 


Note: When you assign the SERIALNO attribute, make sure to 


supply as a parameter the file section number found in the 
REQUEST_AND_RESPONSE array word [9].[15.16]. 


CANDIDATE_TASK (Task, Input/Output) . 
The task variable of the process that declared the file. CHECK_TAPE ASSIGNMENT 


can interrogate or modify task attribute values. For related information, refer to the 
discussion of Field [47: 1] of the SOURCE parameter. 


REQUEST_AND_RESPONSE (Real Array [0], Input/Output) 


This parameter stores selected information about the tape file. 
CHECK TAPE ASSIGNMENT can inspect this information, and modify it if desired. 


The LINK words contained in this parameter have the following format: 


Field ' Meaning 
[39:20] Length of item in words. 
[19:20] Index of the word in which the item starts. This index points 


somewhere in the variable part of the array. 


In the following table, the column labeled “Input or Output” indicates whether this 
parameter is input to the procedure, output from the procedure, or both. 


Input or 
Output _ Word/Field Value Meaning 
VO {0].[47: 8] Length of fixed part of record in words 
0 - (0.[39:12) Length of entire record in words 
[0].[27:28] Field reserved for future use 
[1] Serial number in EBCDIC characters 
(binary zeroes indicate no 
specification) 
l [2] Density requested for new volume 
(2}.[47: 1] 0 - Density is not specified. 


continued 
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continued 


~ Input or 
Output 


Word/Field 


[2].[46:39] 
{2}.[ 7: 8] 


[315] 


[6] 


[7] 
[7].[47: 2] 


(7}.[45:46] 


- [8] 


[8}.[47: 1] 


[81.[46: 7] 
[81.[39:20] 
[8].[19:20] 
[9] 


[91.147:32] 


[9].[15:16] 
[10]-{end] 
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Value 


Meaning 
Density is specified. 
Field reserved for future use 


Density code (same range of values as 
DENSITY file attribute) 


Requested scratch pool (in EBCDIC 
characters) for new volume, or zeroes. 
(First byte is binary count of characters 
in the scratch pool name; the count 
byte is not counted.) 


LINK to the standard form name of the 
file (with the usercode removed). 


Volume/catalog information 
Volume status for new volume 
Do not care 

Tape must be nonvolumed. 
Tape must be volumed. 

Field reserved for future use 
Genealogy (for existing volume) 


The permanent file genealogy can 
differ from the logical file genealogy. 


The permanent file genealogy must 
match the logical file genealogy. 


Field reserved for future use 
CYCLE. Default value is 1. 
VERSION. Default value is 0. 
Volume Numbering 

Field reserved for future use 
FILESECTION (REEL) 


Variable length data pointed to by the 
LINKs in this record 
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Procedure Value (Real, Output Only) 


The following is the format of the value returned by the procedure: 
Field Value Meaning 


[47: 1] 0 Operator intervention is required for any tape 
subsequently mounted by the TAPESERVER library to 
be assigned to a request for an existing unlabeled tape. 


1 A tape subsequently mounted by the TAPESERVER 
library should be assigned to a request for an existing 
unlabeled tape, without operator intervention. 


This value is overridden, and operator intervention is 
required, if the SLRESTRICTIONS or S2RESTRICTIONS 
system security option is set or if the CLASS system 
security option has a value of S1 or S2. System security 
options are controlled through the SECOPT (Security 
Options) system command. 


[46:38] Field reserved for future use 
[ 7: 8] 0 Continue search. 
1 Return open error and abandon file search. The open 


result or AVAILABLE file attribute value is 236. If the 
opening process does not trap the open error, the 
system discontinues the process and displays system 
message MSRFIB271: “ASSIGNMENT STOPPED BY 
TAPEMANAGER LIBRARY.” 


2 Do not include tape units. The file search continues, but 
tape files are not considered. This value can be a useful 
response when the MCP invokes 
CHECK_TAPE_ASSIGNMENT for a file whose KIND file 
attribute has a value of DONTCARE. 


3 Return the same value as if an NF (No File) system 
command were entered (abandon file search). 


4 Return the same value as if an OF (Optional File) 
system command were entered (abandon file search). 


lf the OPTIONAL file attribute does not have the value 
TRUE, an open error results. The open result and the 
AVAILABLE file attribute value are each 44 
(ERRORINOPENRSLT). If the opening process does not 
trap the error, the system suspends the process and 
displays system message MSRFIB16: “ILLEGAL 
OPTIONAL FILE.” 


5 Return the same value as if an FR (Final Reel) system 
command were entered (abandon file search). 
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CHECK TAPE PURGE 


The CHECK_TAPE_ PURGE procedure in the TAPEMANAGER library is called by. 
the MCP when an attempt is made to purge a tape. Actions that result in a tape purge 
are the PG (Purge) system command, the SN (Serial Number) system command, and 
tape file close operations with the PURGE option specified. 


The MCP passes CHECK _TAPE PURGE information, including the source of the 
purge request, the unit number of the tape unit, the serial number, and the scratch 
pool to be assigned. 


CHECK TAPE PURGE can inspect the values passed and modify the scratch pool or 
the density. The procedure also must return an indication of whether the purge request 
is to be allowed or denied. 


If this entry point is missing from the TAPEMANAGER library, the result is the same 
as if the purge had been checked and allowed. 


Syntax 
Specify the procedure heading as follows: 
BOOLEAN PROCEDURE CHECK TAPE PURGE (SOURCE, 
REQUEST_AND_RESPONSE) ; 
VALUE SOURCE; 


REAL SOURCE; 
ARRAY REQUEST_AND RESPONSE [8]; 


Explanation 


The description of the parameters follows. 


SOURCE (Real, Input Only) 


The source of the request is laid out as follows: 


Field Value Meaning 
[47:40] Field reserved for future use 
[ 7: 8] 1 The purge is because of a PG (Purge) or SN (Serial 


Number) system command, or a SETSTATUS call 
corresponding to one of these commands. 


2 The tape was closed with the PURGE option. 


REQUEST_AND_RESPONSE (Real Array [0], Input/Output) 


This array has the same layout as a Major Type 15, Minor Type 3 (Tape Volume 
Purged) log entry, except that Words 0 through 2 are not valid. For a description of 
the log entry format, refer to “Major Type 15-Minor Types 1 through 5, 12, and 13: 
Volume Status Entry (LOGMAJVOL)” in Section 3, “Programming Considerations.” 
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The CHECK TAPE PURGE procedure can change the value of the scratch pool or the 
density. If CHECK_TAPE PURGE changes the scratch pool, CHECK_TAPE PURGE 
should also set bit [ 2: 1] in the procedure value. If a TAPESERVER library is in use, 
it can override such changes to the scratch pool. Further if CHECK_TAPE PURGE 
requests a density that is not supported by the tape unit, the MCP proceeds with the 
purge action but does not assign the requested density. 


Procedure Value (Boolean, Output Only) 


The contents of the procedure value are as follows: 


Field 
[47: 8] 


{[39:37] 
[ 2: 1] 


[ 1: 1] 
[ 0: 1] 
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Value 


Meaning 


’ Reason for denying attempt 


No reason given. The MCP displays system 
message MSRDPC177: “PURGE REQUEST 
REJECTED BY TAPEMANAGER.” 


Rejected SERIALNO value. The MCP displays 
system message MSRDPC181: “SERIAL 
NUMBER REJECTED BY TAPEMANAGER.” 


Rejected SCRATCHPOOL value. The MCP displays 
system message MSRDPC183: “SCRATCHPOOL 
REJECTED BY TAPEMANAGER.” 


Field reserved for future use 


CHECK_TAPE_PURGE did not modify the scratch 
pool value. 


CHECK_TAPE_PURGE modified the scratch pool 
value. 


Field reserved for future use 
The purge is allowed. 


The attempt is denied. In this case, no Major Type 
15, Minor Type 3 (Tape Volume Purged) log entry 
is issued. 
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CHECK TAPE REOPEN 


5-32 


The MCP calls the CHECK_TAPE REOPEN procedure in the TAPEMANAGER 
library when a process attempts to open a tape file that was previously assigned to a 
tape volume and was closed with retention. 


The MCP passes parameters to CHECK_TAPE REOPEN, including the file variable, 
the file name, and the unit number of the tape unit. 


CHECK_TAPE REOPEN must return a result indicating whether the file open is to be 
allowed or denied. 


If this entry point is missing from the TAPEMANAGER library, the result is the same 
as if the tape reopen request were accepted. 


Compare this procedure with the CHECK_TAPE ASSIGNMENT and 
CHECK TAPE UNIT_ASSIGNMENT procedures discussed elsewhere in this section. 


Syntax 
Specify the procedure heading as follows: 


BOOLEAN PROCEDURE CHECK _TAPE REOPEN (RETAINED UNIT, 

RETAINED FILE, 
RETAINED FILE_TASK, 
NEW FILENAME) ; 

VALUE RETAINED UNIT; 

REAL RETAINED UNIT; 

FILE RETAINED FILE; 

TASK RETAINED FILE TASK; 

ARRAY NEW FILENAME [21]; 


Explanation 


The description of the parameters follows. 


RETAINED UNIT (Real, Input Only) 


The unit number (external device number) of the tape unit that is to be reused. 


RETAINED FILE (File, Input Only) 


The file variable of the tape file. Any attempt to modify a file attribute results in an 
attribute error. | 


Note that the TAPEMANAGER library should not open the RETAINED FILE, 
because an open action is already underway for that file. If TAPEMANAGER attempts 
to open the file, the open will fail. The open result or AVAILABLE file attribute value is 
234. If the opening process does not trap the open error, the system discontinues the 
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process and displays system message MSRFIB270: “LIBRARY CANNOT OPEN THIS 
FILE.” 


RETAINED FILE_TASK (Task, Input Only) 
The task variable of the process that declared the file. CHECK_TAPE REOPEN can 


interrogate or modify task attribute values. Refer to the discussion of Field [47: 1] of 
the SOURCE parameter of the CHECK _TAPE ASSIGNMENT procedure. 


NEW_FILENAME (Real Array [0], Input Only) 
The file name of the file being opened. By contrast, the FILENAME file attribute 
reflects the current label of the tape unit. The current label is displayed in the output 


from an OL (Display Label and Paths) system command. The current label might 
reflect the FILENAME of a file that was previously opened on the same tape volume. 


Procedure Value (Boolean, Output Only) 


The contents of the procedure value are as follows: 


Field Value Meaning 
[47:47] Field reserved for future use 
{ 0: 1] oO | Directs the MCP to continue processing the file 
open. . 
o Directs the MCP to terminate the file open with an 


open error. The open result or AVAILABLE file 
attribute value is 230. If the opening process does 
not trap the open error, the system discontinues 
the process and displays system message 
MSRFIB268: “REOPEN STOPPED BY 
TAPEMANAGER.” 
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CHECK _TAPE UNIT ASSIGNMENT 


The MCP calls the CHECK_TAPE UNIT_ASSIGNMENT procedure in the 
TAPEMANAGER library when a process attempts to open a tape file that has not yet 
been assigned to a tape volume, and the UNITNO file attribute has been assigned 

a tape unit number. CHECK TAPE UNIT ASSIGNMENT is called regardless of 
whether UNITNO was assigned by the opening process or by a system command such 
as IL (Ignore Label), OU (Output Unit), or UL (Unlabeled). 


The MCP passes parameters to CHECK_TAPE_UNIT_ASSIGNMENT, including the 
specified unit number, the file variable, and the task variable of the declaring process, 
along with other information. Some of the options specify a labeled or unlabeled 
tape, a backup or non-backup tape, an operator entry of a parameter, a tape file only 
or nontape file, and whether the process opening the file is the same as the process 
declaring the file. 


The CANDIDATE FILE is the file variable of the tape file being opened. Note that 
the TAPEMANAGER library should not open the CANDIDATE_FILE, since an open 
operation is already underway for that file. If TAPEMANAGER attempts to open the 
file, the open operation fails. The open result or AVAILABLE file attribute value is 234. 
If the opening process does not trap the open error, the system discontinues the process 
and displays system message MSRFIB270: “LIBRARY CANNOT OPEN THIS FILE.” 


CHECK_TAPE UNIT_ASSIGNMENT can inspect the values passed, and modify the 
file attributes of the file variable if desired. The procedure must return an indication of 
whether the tape volume assignment is to be allowed or denied. If the assignment is 
denied, one of the following actions results: 


e Ifthe requested UNITNO was assigned programmatically to the UNITNO file 
attribute, the MCP invokes the CHECK_TAPE ASSIGNMENT procedure to 
determine whether TAPEMANAGER allows the file open on an unspecified unit. 


e Ifthe requested UNITNO was assigned by an IL, OU, or UL system command, the 
MCP suspends the opening process. : 


The procedure can also indicate whether an unlabeled tape request can be handled by 
the TAPESERVER library without an operator response of a UL system command to a 
request for an unlabeled tape. 


If this entry point is missing from the TAPEMANAGER library, the result is the same 
as if the tape unit request were allowed. . 


Compare this procedure with the CHECK_TAPE ASSIGNMENT and 
CHECK _TAPE REOPEN procedures discussed earlier in this section. 
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BOOLEAN PROCEDURE CHECK TAPE UNIT ASSIGNMENT (SOURCE, 


VALUE SOURCE, 
CANDIDATE_UNIT3 


REAL SOURCE, 


CANDIDATE_UNIT; 
FILE CANDIDATE FILE; 
TASK CANDIDATE FILE TASK; 


Explanation 


CANDIDATE FILE, 
CANDIDATE FILE TASK, 
CANDIDATE _UNIT) ; 


The description of the parameters follows. 


SOURCE (Real, Input Only) 


The source of the request. This array is laid out as follows: 


Field 
[47: 1] 


(46: 1] ° 


[45: 1] 


[44: 1] 


[44:37] 
[ 7: 8] 
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Value 


re OO fF O 


‘Meaning 


Indicates whether the process opening the file is 
the same as the process declaring the file. The 
task variable of the declaring process is passed in 
the CANDIDATE_TASK parameter. The task 
variable of the opening process can be accessed 
by way of the MYSELF predeclared task variable. 


The opening process and the declaring process are 
the same. 


The opening process is different from the declaring 
process. 


The request is for a labeled tape. 
The request is for an unlabeled tape. 
Only a tape file can satisfy the request. 


The request can be satisfied by a tape file or a 
nontape file (for example, a logical file with 
KIND = DONTCARE). 


The request is not for a backup tape. 
The request is for a backup tape. 
Field reserved for future use 


The UNITNO file attribute was specified or an 
operator entered the OU (Output Unit) system 
command. 


continued 
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continued 
Field | Value . Meaning 
4 An operator entered on IL (Ignore Label) system 
command. 
5 An operator entered a UL (Unlabeled) system 
command. 


CANDIDATE_FILE (File, Input/Output) 


CANDIDATE _FILE is the file variable of the tape file being opened. 

CHECK TAPE _UNIT_ASSIGNMENT can interrogate the file attribute values, but 
cannot modify them. An attempt to modify file attribute values results in an attribute 
error The ATTERR file attribute is set to 177, and the system displays system error 
message MSRATTERR177: “ERROR: ATTRIBUTE MODIFICATION PROHIBITED 
FOR THIS FILE PARAMETER.” 


CANDIDATE_TASK (Task, Input Only) 


The task variable of the process that declared the file. 

CHECK_TAPE UNIT_ASSIGNMENT can interrogate task attribute 

values. For related information, refer to the discussion of Field [47: 1] of the SOURCE 
parameter. 


CANDIDATE_UNIT (Real, Input Only) 


The unit number (external device number) of the requested unit in binary. 


Procedure Value (Real, Output Only) 


The procedure value is divided into the following fields: 


Field Value Meaning 

[47:47] Field reserved for future use. 

[0: 1] 0 Assignment to this tape unit is approved. 
1 Assignment to this tape unit is rejected. 


If CHECK_TAPE_UNIT_ASSIGNMENT is invoked 
because the UNITNO file attribute is specified, the 
MCP resets the UNITNO file attribute to a null 
value and invokes the 
CHECK_TAPE_ASSIGNMENT procedure to 
reevaluate the open request. 


lf CHECK _TAPE_UNIT_ASSIGNMENT is invoked 
because the operator enters an IL, OU, or UL 
system command, the opening process remains 
suspended with a condition that does not request 
a specific tape unit. 
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CONTROL_INTERFACE 


The TAPEMANAGER INITIALIZATION independent runner calls the 
CONTROL_INTERFACE procedure in the TAPEMANAGER library when the library 
is being initialized. Refer to “Initiating the TAPEMANAGER Library” later in this 
section. 


The TAPEMANAGER TERMINATION independent runner calls the 
CONTROL_INTERFACE procedure when the library is being terminated by the SEND 
TM QUIT form of the SEND (Send Message) system command. Refer to “Terminating 
the TAPEMANAGER Library” later in this section. If the SEND TM QUIT <text> 
command is used, the text is passed to the REQUEST parameter of the procedure. 


The MCP generates the response to the SEND TM STATUS command. It is 
unnecessary to include any code in the TAPEMANAGER library to generate this 
response. 


CONTROL_INTERFACE can be designed to return a Boolean procedure value to cause 
the initiation or termination request to be terminated. 


If this entry point is missing from the TAPEMANAGER library, the library cannot be 
initialized. 
Syntax 
Specify the procedure heading as follows: 
BOOLEAN PROCEDURE CONTROL_INTERFACE (SOURCE, 
REQUEST) ; 
VALUE SOURCE; 


REAL SOURCE; 
ARRAY REQUEST [8]; 


Explanation 


' The description of the parameters follows. 


SOURCE (Real, Input Only) 


The type of request. The following are the possible values: 


Value Meaning 
1 Start library. 
2 Stop library. 
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REQUEST (Real Array [0], Input Only) 
This array contains any text specified by the operator ina SEND TM QUIT <text> 
system command. The format of the array is as follows: 

Word Meaning 


0 | The length of the input text, not counting this word. Although a full word is 
used to store the length, the length itself is expressed in units of bytes. 


l-end The input text. The meaning of this text is determined by the 
TAPEMANAGER implementation. 


Procedure Value (Boolean, Output Only) 


The CONTROL INTERFACE procedure can reject the start or stop request by 
returning a value of TRUE in the procedure value. 


If CONTROL_INTERFACE rejects a start request, the MCP terminates 
the TAPEMANAGER library and displays system message MSRMISC214: 
“TAPEMANAGER FAILED IN INITIALIZATION PROCEDURE.” 


If CONTROL_INTERFACE rejects a stop request, the MCP terminates the 


TAPEMANAGER library anyway, but displays system message MSRMISC215: 
“TAPEMANAGER FAILED IN TERMINATION PROCEDURE.” | 
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PROGRAM_INTERFACE 


The MCP calls the PROGRAM INTERFACE procedure in the TAPEMANAGER library 
when a user process invokes the exported MCP procedure CALL_TAPEMANAGER. 
The PROGRAM_INTERFACE and CALL_TAPEMANAGER procedures are designed 
to make it possible for user programs to communicate with the library without linking 
to it directly. The use of CALL_TAPEMANAGER as a jacket procedure is necessary __ 
because only the MCP is allowed to link to the TAPEMANAGER library. For further 
information, refer to “CALL_TAPEMANAGER?” later in this section. 


The PROGRAM _INTERFACE procedure receives an indication of whether the user 
program is privileged, and an array containing input from the user program. The 
format and meaning of this information is defined by the TAPEMANAGER library 
implementation. 


The PROGRAM INTERFACE procedure can modify the input array to record its 
response. PROGRAM_INTERFACE can also return an integer procedure value whose 
meaning is defined by the implementation. Values less than or equal to 0 are reserved 
for use by the MCP to record CALL _TAPEMANAGER errors. 


If the PROGRAM_INTERFACE procedure is not present in the TAPEMANAGER 
library, and a user program invokes the CALL_TAPEMANAGER procedure, the user 


program proceeds normally and CALL _ TAPEMANAGER returns a procedure result 
value of 0. 


Syntax 
Specify the procedure heading as follows: 
REAL PROCEDURE PROGRAM_INTERFACE (CALLER, 
REQUEST_AND_ RESPONSE) ; 
VALUE CALLER; 


REAL CALLER; 
ARRAY REQUEST AND RESPONSE [*]; 


Explanation 


The description of the parameters follows. 


CALLER (Real, Input Only) 


The contents of the CALLER parameter are as follows: 


Field Value Meaning 
[47: 1] 1 The caller is privileged. 
[46:47] Field reserved for future use 
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REQUEST_AND_RESPONSE (Real Array [*], Input/Output) 


Defined by the library implementation 


Procedure Value (Real, Output Only) 


This value is copied to the CALL_TAPEMANAGER procedure result, where it can be 
read by the user program. Values greater than 0 have meanings defined by the library 
implementation. 


A value of 0 is ambiguous to the user program, because CALL_TAPEMANAGER also 
returns a value of 0 if PROGRAM INTERFACE is not present in the TAPEMANAGER 
library. Therefore, PROGRAM_INTERFACE should not use a 0 value to convey 
information to the user program. 


If the value is less than 0, the constant value —2, indicating an incorrect value, is 
returned to the caller of CALL_TAPEMANAGER. 


8600 0940-000 


TAPEMANAGER Library Implementation (cont.) | 


Sample TAPEMANAGER Library 


Two sample programs, both written in DCALGOL, are provided in this section to 
demonstrate some of the features available with the TAPEMANAGER interface. They 
are not intended to be used as an actual TMS. 


The first program comprises a TAPEMANAGER library, and includes sample code for 
each supported TAPEMANAGER procedure as well as an example of a call to the 
exported MCP procedure CALL_TAPEMANAGER. The first program refers to another 
program called CT/SET/VOLFAM/SERIALNO, which is the second sample program 
and is an example of a TMS program that uses the interface to the TAPEMANAGER 
library. 


$ SET INSTALLATION 1 

BEGIN 

LABEL AWAY; 

LIBRARY MCPSUPPORT (LIBACCESS=BYFUNCTION, FUNCTIONNAME="MCPSUPPORT") ; 
ARRAY VOLFAM SERIALNOS [@:9,8:9]; 


REAL PROCEDURE CALL_TAPESERVER (UNLINKED ACTION, A); 
VALUE UNLINKED ACTION; 
REAL UNLINKED ACTION; 
ARRAY A[*]; 
LIBRARY MCPSUPPORT; 


PROCEDURE CHECK HISTORY; 

BEGIN 

REAL TYPE,CAUSE, REASON; 

TYPE := MYSELF.HISTORYTYPES 

IF TYPE NEQ VALUE(NORMALV) THEN 
BEGIN 
CAUSE := MYSELF.HISTORYCAUSE$ 
REASON := MYSELF.HISTORYREASON; 
DISPLAY ("HISTORY: " !! STRING (TYPE,*) !! "," !! 

STRING (CAUSE,*) !! "," !! STRING(REASON,*)) 5 

END; 

END CHECK HISTORY; 


REAL PROCEDURE CHECK TAPE_ASSIGNMENT (SOURCE, F, DECLARER, A); 
VALUE SOURCE; 
REAL SOURCE; 
TASK DECLARER; 
ARRAY A[S]; 
FILE F; 
BEGIN : 
ARRAY FN[@:43]; % FILENAME FROM FILE 
ARRAY AFN[@:43]; % FILENAME FROM ARRAY 
ARRAY MSG[@:38]; 
REAL FILE SECTION; 
POINTER P, AFNP; 
EBCDIC ARRAY EA[@:71]; 
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REAL RETURNVAL; 
LABEL BACK; 
ON ANYFAULT, 
BEGIN 
DISPLAY ("PDUMP") ; 
PROGRAMDUMP ; 
GO BACK; 
END; 


of oe 


Display the parameters of the request 


3© 


° 


REPLACE POINTER(FN) BY F.TITLE; 
REPLACE P:POINTER(MSG) BY "GET "$ 
CASE A[7]. [47:2] OF 
BEGIN 
G: ; 
1: REPLACE P:P BY "NON~VOLUMED "3; 
2: REPLACE P:P BY "VOLUMED "; 
END; 
IF BOOLEAN(SOURCE.[46:1]) THEN 
REPLACE P:P BY "UNLABELED "; 
CASE SOURCE.[7:8] OF 
BEGIN 
(1): REPLACE P:P BY "OUTPUT "; 
(2): REPLACE P:P BY “INPUT "; 
ELSE: REPLACE P:P BY 
"(SOURCE=",SOURCE.[7:8] FOR * DIGITS,") "; 
END CASES; 
IF BOOLEAN(SOURCE. [44:1]) THEN 
REPLACE P:P BY "BACKUP "“; 
IF BOOLEAN(SOURCE.[45:1]) THEN 
REPLACE P:P BY "FILE " 
ELSE 
REPLACE P:P BY "TAPE "$ 
AFNP := POINTER (AFN); 
STANDARDTODISPLAY (POINTER(A[A[6]]) ,AFNP) ; 
REPLACE P:P BY POINTER(AFN) FOR 38 UNTIL="."; 
IF A[1] ISNT @ THEN 
REPLACE P:P BY " [" ,POINTER(A[1]) FOR 6, "]"; 
FILE SECTION := A[9].[15:16]; | 
REPLACE P:P BY " #", FILE SECTION FOR * DIGITS; 
IF SOURCE.[7:8] = 2 THEN 
IF BOOLEAN(A[8].[47:1]) THEN % EXACT 
REPLACE P:P BY " ",A[8].[39:20] FOR * DIGITS, % CYCLE - 
"3" ,A[8].[19:28] FOR * DIGITS % VERSION 
ELSE 
REPLACE P:P BY " (",A[8].[39:20] FOR * DIGITS, % CYCLE 
":" ,A[8].[19:20] FOR * DIGITS,% VERSION 
yes 
IF BOOLEAN(A[2].[47:1]) THEN 
CASE A[2].[7:8] OF 
BEGIN 


5-42 a 8600 0940-000 


8600 0940-000 


TAPEMANAGER Library Implementation 


4) REPLACE P:P 
1: REPLACE P:P 
2: REPLACE P:P 
3: REPLACE P:P 
4 REPLACE P:P 
5: » REPLACE P:P 
6: REPLACE P:P 


IF A[3].[47:8] GTR @ THEN 


BY 
BY 
BY 
BY 
BY 
BY 
BY 


REPLACE P:P BY " POOL=", 


REPLACE P:P BY 48"go"; 
DISPLAY (MSG) ; 


a (888) iT] ; 

" (556) " ; 

" (228) “ ; 

" (1628) "; 
"(6250)"; 
" (38008) "; 
"(1258)"; 


POINTER(A[3])+1 FOR A[3]. [47:8]; 


%The remainder of this procedure is a set of examples 
%that perform different actions based on the file name. 


IF POINTER(FN) = "GET VOLFAM_" THEN 


BEGIN 


%Change SERIALNO to that provided by CT/SET/VOLFAM/SERTALNO 
TRUTHSET DIGIT CHARACTERS ("8123456789") ; 


REAL FAM, SNTOUSE; 


IF POINTER(FN)+11 IN DIGIT | CHARACTERS FOR 1 THEN 


BEGIN 


FAM:=INTEGER(POINTER(FN) +11, 1); 
IF SNTOUSE := VOLFAM SERIALNOS [FAM,FILE SECTION] 


ISNT @ THEN 
BEGIN 


F(FILE SECTION).SERIALNO := SNTOUSE; 
REPLACE P:POINTER(MSG) BY 


"SERIALNO (", FILE SECTION FOR * DIGITS, ")", 
MSEL TO", 


DISPLAY (MSG) ; 


END; 
IF FAM = 9 THEN 
BEGIN 


SNTOUSE, 48"8"; 


%Allow unlabeled assignment to tape mounted 
%by TAPESERVER library 

RETURNVAL := 8 & 1 [47:1]; % OK TO UL 
DISPLAY ("WILL UL SERVER MOUNT"); 


END; 
END; 
END; 


IF POINTER(FN) = "ORACLE." THEN 


BEGIN 


%Display information about the tasks involved with the file 
DEFINE TELL ABOUT (TSK,ID) = 


BEGIN 


REPLACE P:POINTER(HSG) BY-ID, "3: "3 
REPLACE P:P BY TSK.STACKNO FOR 4 DIGITS; 


REPLACE P:P BY " 


(" 


TSK.USERCODE ; 


REPLACE P:P-1 BY ") ", TSK.NAME; 


(cont.) 
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REPLACE P:P-1 BY 48"gg";_ 
DISPLAY (MSG); 7 
END #3 
TELL_ABOUT (MYSELF,"MYSELF") ; 
TELL_ABOUT (MYJOB,"MYJOB") ; 
IF BOOLEAN(SOURCE.[47:1]) THEN 
TELL_ABOUT (DECLARER, "DECLARER") ; 
END; 


IF POINTER(FN) = "“AUTOUNLOAD_" THEN 


BEGIN 
%Set the AUTOUNLOAD attribute 
LABEL SKIPMSG; 
IF POINTER(FN)+11 ="ON" THEN 
F.AUTOUNLOAD := VALUE(ON) 
ELSE 
IF POINTER(FN)+11 ="OF" THEN 
F.AUTOUNLOAD := VALUE(OFF) 
ELSE 
IF POINTER(FN)+11 ="DO" THEN 
F.AUTOUNLOAD := VALUE (DONTCARE) 
ELSE 
GO SKIPMSG; 
DISPLAY (“AUTOUNLOAD CHANGED") ; 


SKIPMSG: 


END; 


IF POINTER(FN) = "WILL" THEN 


BEGIN 
DISPLAY ("CHANGING FILE") ; 
IF POINTER(FN)+5 ="Y." THEN 
REPLACE POINTER(FN) BY "NILLY."; 
IF POINTER(FN)+5 ="Y/FILE@Q@." THEN 


REPLACE POINTER(FN) BY "NILLY/FILEQ@0."; 


IF POINTER(FN)+5 ="YNILLY/FILEQ@@." THEN 
REPLACE POINTER(FN) BY “WILLYNILLY."; 

F.DIOFILESTRUCTURE := VALUE (ALIGNED189) ; 

F.SAVEFACTOR := 123; 

F.VERSION := 23 

F.CYCLE =. 3s 

F.DENSITY := VALUE(BPI16@9) ; 

REPLACE F.SCRATCHPOOL BY "DUMMY."3; 

REPLACE F.FILENAME BY POINTER(FN) 3 

END; 


IF POINTER(FN) = "FILM." THEN 


BEGIN 

%Prevent assignment to a tape unit 
DISPLAY ("TAPE WILL BE IGNORED"); 
RETURNVAL := 23 

END; 


IF POINTER(FN) = "OPEN_F." THEN 


BEGIN 
%Attempt to open the file passed in 


% ERROR TEST 


% ERROR TEST 
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OPEN (F); . % ERROR TEST 
END; 


%Test the various return values 

IF POINTER(FN) = “OK_TO_UL" THEN 
RETURNVAL := 9 & 1 [47:1] 

ELSE IF POINTER(FN) = "CAN NOT OPEN" THEN 
RETURNVAL := 1 . 

ELSE IF POINTER (FN) = "OF ME" THEN 
RETURNVAL := 4 ; 

ELSE IF POINTER (FN) 
RETURNVAL := 3 

ELSE IF POINTER (FN) 
RETURNVAL := 5; 


"NF_ME" THEN 


"FR ME" AND F.FILESECTION = 2 THEN 


CHECK HISTORY; 

DISPLAY ("RETURNING NOW, [47:1] = " !! STRING(RETURNVAL. [47:1] ,*) 
. tio", [7:8] = " !! STRING(RETURNVAL.[ 7:8] ,*))3 

CHECK_TAPE ASSIGNMENT := RETURNVAL; 

END CHECK TAPE ASSIGNMENT; 


BOOLEAN PROCEDURE CHECK_TAPE_REOPEN(U,F,TSK,NEW FN); 
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VALUE U; 

REAL Us; 

FILE Fs; 

TASK TSK3 % DECLARER TASK 

ARRAY NEW FN [@]; % NEW FILE NAME IN STANDARD FORM 
BEGIN 


ARRAY FN[@:9]; 
ARRAY NFN[@:9]; % NEW FILE NAME IN DISPLAY FORM 
POINTER NFNP3 
POINTER P3 
REAL TSKMIX; 
ARRAY MSG[@:28] ; 
REPLACE POINTER(FN) BY F.FILENAME; 
NFNP := POINTER(NFN) ; 
ON ANYFAULT, 
BEGIN 
DISPLAY ("FAULT"); 
PROGRAMDUMP (ARRAYS) ; 
END; 
STANDARDTODISPLAY (POINTER(NEW FN) ,NFNP) ; 
IF FN = "CAN NOT REOPEN" THEN 
BEGIN | 
%Deny the reopen 
DISPLAY ("REOPEN DENIED"); 
CHECK _TAPE REOPEN := TRUE; 


END 
ELSE ~ 
BEGIN 
%Display the parameters of the request and grant permission 
IF POINTER(NFN) = "“.". FOR 1 THEN 
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PROGRAMDUMP (ARRAYS,FILES) ; 
REPLACE P:POINTER(MSG) BY "REOPEN OF ", 


POINTER(FN) UNTIL = ".", 
"ON MT", U FOR * DIGITS, 
wu AS u § 

POINTER(NFN) UNTIL = "."; 


TSKMIX := TSK.STACKNO; 
IF TSKMIX NEQ MYSELF.STACKNO THEN 
REPLACE P:P BY " FOR MIX ", TSKMIX FOR * DIGITS; 
REPLACE P:P BY " OK"48"@6"; 
DISPLAY (MSG) ; 


END; 
IF FN = "TRY _TO CHANGE" THEN 
BEGIN 
%Attempt to modify a file attribute 
F.SAVEFACTOR := 123; %ERROR TEST 


END CHECK_TAPE_REOPEN; 


BOOLEAN PROCEDURE CHECK_TAPE_UNIT ASSIGNMENT (SOURCE,F,DECLARER,U) ; 

VALUE SOURCE,U; 
REAL SOURCE,U; 
FILE F3 
TASK DECLARER; 
BEGIN , 
EBCDIC ARRAY EA [8:71]; 
ARRAY FN [8:42]; 
POINTER P3; 
%Display the parameters of the request and 
%request permission to continue 
REPLACE POINTER(FN) BY F.TITLE; 
REPLACE P:EA BY "OK TO PUT "; 
IF BOOLEAN (SOURCE. [46:1]) THEN 

REPLACE P:P BY "UNLABELED "3; 
IF BOOLEAN(SOURCE.[44:1]) THEN 

REPLACE P:P BY "BACKUP "3; 
IF BOOLEAN(SOURCE.[45:1]) THEN 

REPLACE P:P BY "FILE " 
ELSE 

REPLACE P:P BY "TAPE "3; 
REPLACE P:P BY POINTER(FN) FOR 3@ UNTIL=".", " "3 
IF BOOLEAN(SOURCE.[47:1]) THEN 

REPLACE P:P BY "FOR TASK ",DECLARER.STACKNO FOR * DIGITS, " "3; 

REPLACE P:P BY "ON "$ 
CASE SOURCE.[7:8] OF 

BEGIN 

3: IF U NEQ F.UNITNO THEN 

REPLACE P:P BY "QU-ED "3 
4: REPLACE P:P BY "IL-ED "; 
5: REPLACE P:P BY "UL-ED "3 
ELSE:REPLACE P:P BY 
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"(SOURCE=",SOURCE.[7:8] FOR * DIGITS,") "; 
END; 
REPLACE P:P BY "UNIT ",U FOR * DIGITS, "2"48"98"; 
%Request action from operator 
ACCEPT (EA) ; 
IF EA = "N" THEN 
CHECK .TAPE_UNIT ASSIGNMENT := TRUE; 
END; 


BOOLEAN PROCEDURE CONTROL_INTERFACE (WHAT,A) ; 
VALUE WHAT; 
REAL WHAT; 
ARRAY A[@]; 
BEGIN 
ARRAY SHOW MESSAGE [:7]; 
ON ANYFAULT, 
BEGIN 
DISPLAY ("FAULT"); 
PROGRAMDUMP (ARRAYS) ; 
END; 
DISPLAY ("TAPEMGR CONTROL " !! STRING (WHAT,*) !! " RECEIVED"); 
REPLACE POINTER(SHOW MESSAGE) BY “A[{@] = #", 
POINTER (A[@],4) FOR 12 
WITH HEXTOEBCDIC; 
DISPLAY (POINTER(SHOW MESSAGE)) ; | 
IF A[@] > @ THEN 
BEGIN 
%Handle optional text 
REPLACE POINTER(SHOW MESSAGE) BY "TEXT: ", 
POINTER(A[1]) 
FOR MIN(41,A[9]), 
48"99" ; 
DISPLAY (POINTER(SHOW MESSAGE) ) ; 
IF A[@] = 5 THEN 
IF POINTER(A[1]) = "FAULT" THEN 


BEGIN 

INTEGER [3 

DISPLAY ("WILL CAUSE FAULT"); % ERROR TEST 
I:= I/Is 

END; 


END; 
END CONTROL_INTERFACE; 


REAL PROCEDURE PROGRAM INTERFACE (CALLER,A) ; 
VALUE CALLER; 
REAL CALLER: 
ARRAY A[*]; 
BEGIN 
DEFINE PRIV CALLER = BOOLEAN(CALLER. [47:1])#; 
REAL SR; 
ARRAY MSG[@:14]; 
POINTER P; 
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LABEL AWAY; 


IF A[@] = "VOLFAM" THEN % FOR CT/SET/VOLFAM/SERIALNO 
BEGIN 
“Update entry in VOLFAM SERIALNOS array 
IF A[3]="@@0000" THEN 
A[3] =; \ 
VOLFAM_SERIALNOS [A[1] ,A[2]]:=A[3]; 
GO AWAY; 
END; 


%Display the parameters of the request 


P:= POINTER(MSG) ; 

IF PRIV_ CALLER THEN 
REPLACE P:P BY "PRIVILEGED By 

REPLACE P:P BY "PROGRAM SAYS: "$ 

REPLACE P:P BY POINTER(A) FOR 38 UNTIL = 48"98", 48"99"; 

DISPLAY (POINTER(MSG) ) ; 

IF P:POINTER(A) = "SERVER " THEN 
BEGIN 
%Pass remainder of message to TAPESERVER library 
ARRAY SVRMSG [8:14]; 
REPLACE POINTER(SVRMSG) BY P FOR 82 sales = 48°00" , 48"06" ; 
DISPLAY ("CALLING SERVER"); 
SR:=CALL_TAPESERVER(@,SVRMSG) ; 
END; 

%Return a result to the caller 

PROGRAM_INTERFACE := SR * 188 + 3; 

AWAY: 
END PROGRAM_INTERFACE; 


BOOLEAN PROCEDURE CHECK TAPE PURGE (SOURCE,A); 
VALUE SOURCE; 
REAL SOURCE; 
ARRAY A[@]; 


BEGIN 
DEFINE OLDSN = A[ 6] #, 

NEWSN = A[17] #, 

NEWDEN= A[18].[31:9] #, 

POOL = A[22] #; % 3 WORDS LONG 
POINTER P3; 


ARRAY MSG[@:11]; 
REAL REASON; 


oe 


%Display the parameters of the request 


oe 


P:=POINTER(MSG) ; 
CASE SOURCE. [7:8] OF 
BEGIN 
1: 3 % SETSTATUS CALL 
2: REPLACE P:P BY "CLOSEPG, "; 
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ELSE: REPLACE P:P BY "SOURCE=", SOURCE.[7:8] FOR * DIGITS; 
END; 
IF OLDSN IS @ THEN 
REPLACE P:P BY "NO OLD SN, " 
ELSE 
REPLACE P:P BY "OLD SN = ",POINTER(OLDSN) FOR 6, ", "; 
IF NEWSN IS @ THEN 
REPLACE P:P BY "NO NEW SN" 
ELSE 
REPLACE P:P BY "NEW SN = “,POINTER(NEWSN) FOR 6; 
IF POOL. [47:8] > @ THEN 
REPLACE P:P BY ", POOL 
REPLACE P:P BY 48"@8"; 
DISPLAY (MSG); 


"', POINTER(POOL)+1 FOR POOL. [47:8]; 


oe 


x 


Take various actions depending on serial number 
and/or pool name 


x 


Oe 


IF OLDSN = "PERMIT" THEN 
DISPLAY ("ANYTHING GOES") 
ELSE IF NEWSN.[47:48] = "MPOOL" THEN 
CHECK TAPE PURGE := TRUE & BOOLEAN(2) [47:98] 
ELSE IF NEWSN.[47:48] = "MSNUM" THEN 
CHECK TAPE PURGE := TRUE & BOOLEAN(1) [47:98] 
ELSE IF NEWSN.[47:48] = "MTELL" THEN 
BEGIN 
REPLACE POINTER(MSG) BY "MT", A[4] FOR * DIGITS, 
" NOT PURGED BECAUSE YOU TOLD ME NOT TO"48"gg"; 
DISPLAY (MSG); 
CHECK_TAPE PURGE := TRUE; 
END 
ELSE IF NEWSN.[47:4@] = "MDENY" THEN 
CHECK TAPE PURGE := TRUE 
ELSE IF NEWSN.[47:48] = "MDSME" THEN 
MYSELF.STATUS := VALUE (TERMINATED) 
ELSE IF NEWSN.[47:48] = "M1620" THEN 
NEWDEN := VALUE(BPI169@) 
ELSE IF NEWSN.[47:4@] = "M1259" THEN 
NEWDEN := VALUE(BP11258) 
ELSE IF POINTER(POOL) = 48"QA"8"CHANGE MGR" THEN 
BEGIN , 
REPLACE POINTER(POOL) BY 
48"07"8" CHANGED" ; 
CHECK_TAPE PURGE := FALSE & BOOLEAN(1) [2:1]; 


END 
ELSE IF POINTER(POOL) = 48"QD"8"CHANGE ME_TRY" THEN 
BEGIN % ERROR TEST 


DISPLAY ("TRYING CHANGE WITHOUT BIT"); 
REPLACE POINTER(POOL) BY 

48"87"8" CHANGED" ; 
% FORGET TO CHANGE BIT 2 AND SEE WHAT HAPPENS 
END 
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ELSE IF POINTER(POOL) = 48"@D"8"CHANGE ME BAD" THEN 
BEGIN % ERROR TEST 
DISPLAY ("TRYING BIGGER NAME"); 
REPLACE POINTER(POOL) BY 
48"12"8"LENGTH TOO BIG"; 
% WILL FAULT IF REALLY MAKE TOO BIG: 
% ONLY 3 WORDS LEFT IN ARRAY 
CHECK_TAPE_PURGE := FALSE & BOOLEAN(1) [2:1]; 
END; 
END CHECK TAPE PURGE; 


EXPORT CHECK_TAPE ASSIGNMENT, 
CHECK TAPE_UNIT ASSIGNMENT, 
CHECK TAPE_REOPEN, 
CHECK TAPE PURGE, 
PROGRAM_INTERFACE, 
CONTROL_INTERFACE; 

FREEZE (TEMPORARY) ; 

AWAY: 

END. - 
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The following sample program is called CT/SET/VOLFAM/SERIALNO. It is referenced 
by the previous sample program, and is an example of a program that calls the 
CALL _TAPEMANAGER procedure. 


$ SET LEVEL 2 
PROCEDURE SETSN(A); 
ARRAY A[*]; % A IS STRING OF UPTO 9 SERIALNOS, STARTING WITH FS 1 
% VALUE IS VOLFAM FOR WHICH IT IS BEING SET 
BEGIN 
LIBRARY MCP (LIBACCESS=BYFUNCTION, FUNCTIONNAME="MCPSUPPORT") ; 
REAL PROCEDURE CALL_TAPEMANAGER (UNLINKED. ACTION, A); 
VALUE UNLINKED ACTION; 
REAL UNLINKED ACTION; 
ARRAY A[*]; 
LIBRARY MCP; 
ARRAY INPUTMSG [0:14]; 
POINTER PA; 
INTEGER FS; 
REAL R; 
INPUTMSG[@] :="VOLFAM" ; 
INPUTMSG[1] :=MYSELF. TASKVALUE; 
PA:=POINTER(A) ; 
WHILE PA NEQ 48"g2" DO 
BEGIN 
INPUTMSG[2] :=*+1; | 
REPLACE POINTER(INPUTMSG[3]) BY PA:PA FOR 6; 
R:=CALL_TAPEMANAGER(@, INPUTMSG) ; 
END; 
END. 
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Exported MCP Procedures for Tape Management 


The following exported MCP procedures provide functions related to tape management: 
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CALL_TAPEMANAGER. Tape management utilities can use this procedure to 
communicate with the TAPEMANAGER library. The CALL_TAPEMANAGER 
procedure is described in the following pages. 


CALL_TAPESERVER. The TAPEMANAGER library or other software can use this 
procedure to communicate with the TAPESERVER library. For more information 
about the A Series RoboHost A TAPESERVER library features and functions, refer 
to the A Series RoboHost A Programming Guide. 


REPORT_LOG_ENTRIES. A TMS can use this procedure to monitor successful 
tape actions. Refer to the A Series System Software Support Reference Manual for 
the detailed procedure. 


STATUS_CHANGE_ REQUEST. A TMS can use this procedure to obtain 


information about tape events. Refer to the A Series System Software Support 
Reference Manual for the detailed procedure. 


GETSTATUS and SETSTATUS. A TMS can use these functions to obtain 
information about the status of tape units on the system. Refer to the A Series 
GETSTATUS/SETSTATUS Programming Reference Manual. . 


SYSTEMSTATUS. A TMS can use this function to determine the number and type 
of tape units available on the system. Refer to the A Series SYSTEMSTATUS 
Programming Reference Manual. 
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CALL_TAPEMANAGER Procedure 


The CALL_TAPEMANAGER procedure in the MCPSUPPORT library can be called 
by any program that needs to communicate with the TAPEMANAGER library. The 
CALL_TAPEMANAGER procedure in turn invokes the PROGRAM INTERFACE 
procedure in TAPEMANAGER. CALL_TAPEMANAGER is provided so that user 
programs can communicate with the TAPEMANAGER library, even though only the 
MCP is allowed to link to TAPEMANAGER directly. 


CALL_TAPEMANAGER accepts an array parameter that it passes through to 
PROGRAM_INTERFACE. CALL_TAPEMANAGER also accepts a parameter 
indicating the action to be taken if the TAPEMANAGER library status is not ACTIVE. 


_ The CALL_TAPEMANAGER procedure returns immediately if the TAPEMANAGER 
system option has not been set by the SYSOPS (System Options) system command. 
If the TAPEMANAGER library status is not ACTIVE, the CALL_TAPEMANAGER 
procedure informs the operator that the library is not ACTIVE, and either waits until 
it becomes ACTIVE or returns immediately, depending on the caller’s request. A 
CALL_TAPEMANAGER call does not itself cause the library to be initiated. 


If PROGRAM _ INTERFACE modifies the array parameter passed to it, these 
changes are reflected when the parameter is returned by CALL_TAPEMANAGER. 
Also, CALL_TAPEMANAGER returns a procedure value that either duplicates the 
procedure value returned by PROGRAM INTERFACE, or indicates that the MCP is 
unable to invoke PROGRAM_INTERFACE. 


For further information, refer to “PROGRAM_INTERFACE” earlier in this section. 


Syntax 
‘Specify the procedure heading and the MCPSUPPORT library as follows: 
LIBRARY MCPSUPPORT(LIBACCESS = BYFUNCTION,FUNCTIONNAME = "MCPSUPPORT.") ; 


REAL PROCEDURE CALL_TAPEMANAGER (UNLINKED ACTION, 
REQUEST AND RESPONSE) ; 
VALUE UNLINKED ACTION; 
REAL UNLINKED ACTION; 
ARRAY REQUEST_AND RESPONSE [*]; 
LIBRARY MCPSUPPORT 5 
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Explanation 


The description of the parameters follows. 


UNLINKED ACTION (Real, Input Only) 


This parameter is divided into the following fields: 


Field Value Meaning 
[47:40] Field reserved for future use 
[ 7: 8] Action to be taken if the library status is not 
ACTIVE at the time of the call 
0 . Wait until the library status is ACTIVE or an 


operator enters an OF (Optional File) or DS 
(Discontinue) response. 


1 Return immediately. 


Note: This action is taken, regardless of 
the value of 
UNLINKED _ACTION, if the 
SYSOPS TAPEMANAGER system 
option is not set. 


REQUEST _AND_RESPONSE (Real Array [*], Input/Output) 


The contents and meaning of this parameter are defined by the TAPEMANAGER 
library implementation. 


Procedure Value (Real, Output Only) 


The following table describes the meaning of the procedure values: 


Value Meaning 
>0 The meaning is defined by the TAPEMANAGER library implementation. 
0 Either the PROGRAM_INTERFACE procedure was not present in 


TAPEMANAGER, or PROGRAM_INTERFACE returned a value of O for 
implementation-defined reasons. 


-l The TAPEMANAGER library was not called because the library state was 
‘not ACTIVE. 


-2 The TAPEMANAGER library was called but returned an invalid result (that 
is, a result less than QO). 


7 3 The TAPEMANAGER library was not called because the TAPEMANAGER 
system option was not set by the SYSOPS (System Options) system 
command. 
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Operations Interface to the TAPEMANAGER Library 


The following pages discuss only those aspects of the TAPEMANAGER library that are 
of interest to system operators. . 


The TAPEMANAGER library is an optional system library that is implemented by the 
customer site or a third-party vendor. If a TAPEMANAGER library is installed on an 
A Series system, and contains the standard set of exported procedures, then the MCP 
invokes TAPEMANAGER procedures whenever any of the following events occurs: 


@ <A process attempts to open a tape file. 


e A reel switch occurs for a tape file. 


@ A purge request occurs for a tape volume. Purge requests result from PG (Purge) 
and SN (Serial Number) system commands, or from program statements that close 
a file with a disposition of purge. | . 


The MCP uses parameters to pass TAPEMANAGER information about the open, 
reel switch, or purge request. The TAPEMANAGER procedures return results that 
either accept, deny, or modify the request. If an operator modifies an open request 
with system commands such as FA (File Attribute) or OU (Output Unit), the MCP 
invokes the TAPEMANAGER procedures again to verify that the modified request is 
acceptable. 


For more detailed information about the interactions between application programs 
and the TAPEMANAGER library, refer to “Interaction with the Operating System” 


earlier in this section. 


The following paragraphs discuss the steps involved in installing, initiating, 
terminating, and inspecting the status of the TAPEMANAGER library. 


Installing the TAPEMANAGER Library 
Use the following steps to install a TAPEMANAGER library: 
1. Use the SL (Support Library) system command to define the function name 
TAPEMANAGER and to associate the function name with a library code file. The 


following is an example of this command: 


SL TAPEMANAGER = (JASMITH)OBJECT/OURTAPEMANAGER ON DISK 


2. Use the SYSOPS (System Options) system command to set the TAPEMANAGER 
option. The following is an example of this command: 


SYSOPS TAPEMANAGER + 
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Unisys recommends the following additional actions for TAPEMANAGER installation, 
but they are not essential: 


@ Make the library code file private for the reasons discussed under “Security 
Considerations” earlier in this section. For example, you could enter the following 
command at the ODT: 


SECURITY *SYSTEM/TAPEMANAGER ON DISK PRIVATE I0 


e Assign an identity to the library code file. This identity appears in any 


system messages or display messages generated by a process that is executing 
TAPEMANAGER code. You can assign the identity with the MP (Mark Program) 
system command, as in the following example: 


MP *SYSTEM/TAPEMANAGER ON DISK + IDENTITY = TML 


Initiating the TAPEMANAGER Library 


If the TAPEMANAGER function name is defined and the TAPEMANAGER system 
option is set, then you can initiate the TAPEMANAGER library in either of the 


following ways: 


e Enter the SEND TAPEMANAGER START form of the SEND (Send Message) 


system command. This command can be abbreviated to SEND TM START. 


@ Wait for the next halt/load. When the system reinitializes, it automatically initiates 
the TAPEMANAGER library. 


For further information about TAPEMANAGER library initiation, refer to “Starting 
Up” earlier in this section. — 


Inspecting the TAPEMANAGER Status 


You can determine the status of the TAPEMANAGER library by entering the SEND 
TM STATUS form of the SEND (Send Message) system command. The following table 
describes the states that the system can display in response to this command. 
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State 
INACTIVE 
LINKING 


INITIALIZING 


ACTIVE 
TERMINAFING 


Meaning 
The library is not linked, nor is initiation or termination underway. 


The MCP is in the process of linking to the library, and the library has 
not yet frozen. 


~ The MCP is linked to the library, and the CONTROL_INTERFACE 


procedure is currently executing the start request. 
The library is frozen, linked, and available for use. 


A SEND TM QUIT system command has been entered. The: MCP has 
begun suspending any new processes that attempt tape actions requiring 
calls on the library. The CONTROL_INTERFACE procedure is currently 
executing the stop request. 


continued 
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continued 
State Meaning 
WAITING TO The CONTROL_INTERFACE procedure has exited after executing the 
DELINK stop request. The library remains in the WAITING TO DELINK state until 
the MCP delinks from the library, which the MCP does after all 
procedure calls that are currently in progress have completed. 
GOINGAWAY The MCP has delinked from the library. If the library is a TEMPORARY 


library, it unfreezes at this point and resumes execution as a normal 
process. The library remains in the GOINGAWAY state until it 
terminates. 


Terminating the TAPEMANAGER Library 


You can terminate the TAPEMANAGER library by entering one of the following forms 
of the SEND command: 


SEND TAPEMANAGER QUIT 
SEND TAPEMANAGER QUIT <text> 


These commands can also be abbreviated as follows: 


SEND TM QUIT 
SEND TM QUIT <text> 


If text is specified in the command, the text is passed to the RESPONSE parameter of 
the CONTROL_INTERFACE procedure in the TAPEMANAGER library. The meaning 
of the text is determined by the TAPEMANAGER implementation. 


You can also terminate the TAPEMANAGER library process with a DS (Discontinue) 
system command. However, you must bear the following considerations in mind: 


e@ The DS command has no effect on the TAPEMANAGER library process unless you 
first use the <mix number> —LP form of the LP (Lock Program) system command 
to unlock the library process. This step is necessary because the SEND TM START 
command implicitly locks the library process. 


@ The DS command is the nonpreferred method of terminating TAPEMANAGER, 
because it prevents user processes from finishing any open operations that are in 
progress, and prevents TAPEMANAGER from performing any cleanup actions 
that it normally might perform before terminating. 


If the TAPEMANAGER library takes unexpectedly long to terminate, you can check 
the status as described under “Inspecting the TAPEMANAGER Status” earlier in this 
section. The following table lists TAPEMANAGER status values, and actions that the 
operator can take if TAPEMANAGER becomes stuck in one of these states. 
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Status 
TERMINATING 


WAITING TO 
DELINK 


~ GOINGAWAY 


Operator Response 


The CONTROL_INTERFACE procedure is executing, and might have a 
bug that is causing it to loop. You can unlock the library with the LP 
(Lock Program) system command and then discontinue the library with 
the DS (Discontinue) system command. 


It is possible that one of the user processes is suspended or is looping 
because of a bug in one of the TAPEMANAGER exported procedures. If 
you can locate the offending user process, you can discontinue that 
process with a DS command, and the library should then terminate 
normally. tf you cannot locate the offending user process, you can simply 
unlock the library with an LP command and then discontinue the library 
with a DS command. 


It is possible that the library has a PERMANENT freeze that keeps the 
library from unfreezing and resuming execution. You can use the LIBS 
(Library Mix Entries) system command to determine the library freeze 
type. If the freeze is permanent, you can use the THAW (Thaw Frozen 
Library) system command to change the freeze to TEMPORARY, and the 
library should unfreeze and terminate sometime thereafter. 


If the TAPEMANAGER library does not appear in the LIBS display, then _ 
the library has unfrozen and is executing as a normal process. There 
might be a bug in the TAPEMANAGER code that causes it to loop. You 
can unlock the library with an LP command and then discontinue the 
library with a DS command. 


For further information about TAPEMANAGER library termination, refer to 


“Shutting Down” earlier in this section. 


Terminating the TAPEMANAGER library can cause processes that use tapes to 
become suspended. This issue is discussed under the following heading. 


Temporarily Disabling Use of the TAPEMANAGER Library 


If you enter the SYSOPS TAPEMANAGER - command after TAPEMANAGER is 
initiated, the system temporarily disables use of the TAPEMANAGER library. The 
MCP resumes use of the TAPEMANAGER library when you enter the SYSOPS 
TAPEMANAGER + form of the SYSOPS command. 
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Note: While TAPEMANAGER is disabled, the MCP allows processes 
to use tape files as if the TAPEMANAGER library were not 
installed. This behavior is not desirable if you are relying on the 
TAPEMANAGER library to enforce tape security. You might prefer 
to terminate TAPEMANAGER instead, by entering the SEND TM 
QUIT form of the SEND (Send Message) system command. While 
TAPEMANAGER is terminated, processes that attempt to open a 
tape file or purge a tape become suspended, and the operator can 
respond to the waiting entries individually. Refer to “Terminating 
the TAPEMANAGER Library” earlier in this section. 
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Responding to Processes Waiting on the TAPEMANAGER Library 


If the TAPEMANAGER system option is set, then the system attempts to invoke the 
relevant TAPEMANAGER procedures whenever a process attempts to open or purge a 
tape. If the TAPEMANAGER library is not currently linked, for example because an 
operator has terminated the library with a SEND TM QUIT command, then processes 
attempting to open or purge tape files become suspended. The RSVP request, system 
message (MSRMISC220), is: “TAPEMANAGER REQUIRED.” The following table 
describes the possible operator responses and their effects: 


Response Effect 

OK The MCP attempts to call the TAPEMANAGER library again. 

DS The MCP discontinues the process attempting to open the file. 

OF The open or purge request continues as if the TAPEMANAGER library were 
not installed. 


Because TAPEMANAGER might be used to enforce tape security at some 
sites, the MCP limits the use of the OF response. The OF response can be 
_ submitted from the following sources: 


@ ODTs 


@ Remote ODTs; that is, remote terminals granted ODT status by the 
REMOTESPO (Activate REMOTESPO) system command 


@ Nonusercoded MARC sessions 
@ DCKEYIN functions in nonusercoded DCALGOL processes 


The MCP ignores the OF response if it is submitted from CANDE sessions, 
usercoded MARC sessions, or usercoded DCALGOL processes. 


The MCP also resumes execution of the process automatically if TAPEMANAGER 
library linkage completes while the process is suspended. 


A user process can also become suspended if it encounters a fault while executing 

a TAPEMANAGER procedure. The RSVP request in this case is system message 
MSRMISC221: “USER PROCESS FAULTED OR DSED WHILE IN TAPEMANAGER 
LIBRARY CODE.” The possible responses are the same as described previously: OK, 
DS, or OF. For further information, refer to “TAPEMANAGER Error Handling” earlier 
in this section. . | 
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Replacing the TAPEMANAGER Library with a Newer Version 


Use the following steps to replace the currently running TAPEMANAGER library with 
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1, 


‘a newer version: 


Use a WFL COPY statement to copy the new version of the library object code file 
to the desired file name and family. You can assign the same file name and family 
name as the old version has. In this case, the new version of the code file becomes 
a permanent disk file, and the old version of the code file becomes a temporary 
disk file but continues to be used for the moment. 


Enter the SL TAPEMANAGER = <code file title> form of the SL (Support 
Library) system command. Use this command even if the new version of the code 
file has the same title as the old version. This command has no immediate effect 
on the library instance that is running, but it does specify the code file to be used 
the next time the library is initiated. 


Enter a SEND TM QUIT or SEND TM QUIT <text> command to terminate the | 
current TAPEMANAGER library instance. 


Wait until the current TAPEMANAGER library instance terminates. 
TAPEMANAGER has terminated if the SEND TM STATUS command returns a 
status of INACTIVE. 


Enter a SEND TM START command to initiate the new TAPEMANAGER library 
instance. 
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System Messages 


This appendix presents selected A Series system messages generated by the master 
control program (MCP) —specifically, system messages related to A Series tape 
management facilities. 


This appendix does not include any messages generated by system libraries, message 
control systems (MCSs), database management software, or application programs. 


Note: The information in this appendix is based on the A Series System 
Messages Support Reference Manual. 


This appendix follows the basic style and conventions of the A Series System Messages 
Support Reference Manual. That is 


e The explanation of each message consists of two bulleted items, the first describing 
the cause of the error and the second presenting a suggested response. 


@ The associated message number follows the text of the message, and is enclosed in 
parentheses. When a message appears in the log, the message number precedes the 
message text. All system message numbers begin with the characters MSR. 


@ Message presentations include metatokens. Metatokens are variables whose values 
change according to the current situation and the current user. In this appendix, 
metatokens are surrounded by angle brackets (< >). Table A-1 presents some 
of the metatokens that appear in system messages throughout this appendix. A 
metatoken that appears in a limited number of messages is defined with those 
individual messages. When they are included, metatoken definitions follow the 
message text and precede the probable cause of the message. 


@ Messages are presented in alphabetic order. In locating a message alphabetically, 
do not consider the following information and characters at the beginning ofa 
message: 


— Metatokens such as <file name> or <unit name> 
~- Device acronyms such as MT or PK 


— Parentheses and the information they enclose; brackets and the information 
they enclose; and nonalphabetic characters such as numbers, commas, periods, 
and question marks 
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Table A-1. . Metatokens Appearing in Message Listings 


Metatoken Definition 


<family name> Name of a family. 


<FIB error prefix> The following information: 


FILE <file name> <error category> 


The variable <error category> is one of the following: 


OPEN <error type> 

CLOSE <error type> 

1/0 <error type> 

INPUT REEL SWITCH: 

OUTPUT REEL SWITCH: 

I/O ERROR: NO FILES COPIED 
RESPOND: 


The variable <error type> is one of the following: 
WARNING: 
ERROR: 


<file name> Name of a file, with no family name appended. 


<file title> Complete identifier for a file, which consists of the file name, the word ON, 
and the family name. 


<host name> Name of a system as established with the HOSTNAME (Hostname) system 
command. 


<mix number> Mix number of the program that encountered the error described by the 
message. The mix number appears in parentheses. 


<number> An integer. This value can be, for example, hours, minutes, and seconds, 
or it can be the record number of a directory record. In some cases, 
integers are represented in the form mnn and hexadecimal numbers are 
represented in the form AAA. 


<percentage> Percentage of a process that has completed. 


<rcw> Return control word. This value indicates where in the process an interrupt 
or procedure call occurred. 


<rr> Row number in a file. 


<serial number> Either the 6-digit serial number of a disk or the 6-character serial number of 
a tape. 


<serial number list> One or more volume serial numbers. If the list includes more than two 
serial numbers, they might appear as follows: [nnnnnn, .. .nnnnnnj 


<unit identifier> Either a unit name or a unit number. 


continued 


A-2 - 8600 0940-000 


System Messages 


Table A-1. Metatokens Appearing in Message Listings (cont.) 


Metatoken Definition 


<unit kind> Device acronym, such as PK or MT. 
<unit name> Device acronym and unit number, such as PK 97 or MT 80. 


<unit number> Unit number of a peripheral, such 97 or 80. 


<volume description> A volume name, a volume serial number, or both. 


<vol dir extension> An indicator of the reason a volume directory action was taken. 


ADD 

BUILD 
CHANGE 
DELETE 
DESTROYED 
FINDINPUT 
FINDOUTPUT 
‘OPEN 

PG MT 
READALABEL 
REBUILD 
RESTRICT 
SEARCH 
SETSTATUS ADD 
SN MT 


<volume family> PACK, DISK, SCRATCH, or a family name. 


See the System Messages Manual for details on how system messages are documented. 


PK<unit number> ARCHIVE BACKUP ENTRY DELETED 
<file name> ON <family name>, FOR TAPE <tape name> 
[<serial number>] (MSRLM92) 


e The system erased from the family’s archive directory the archive backup 
information for a file previously reported as COPIED AND ARCHIVED. Archive 
information created by an archive backup or rollout operation is erased in either of 
the following situations: 


— A tape is purged in response to a VERIFY error. 


~ The archive process is initiated with the & DSONERROR option and any error 
occurs. 
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@ Determine the cause of the original error. Correct the error and resubmit the WFL 
ARCHIVE statement. 


<FIB error prefix> ASSIGNMENT STOPPED BY TAPEMANAGER 
<rew> (MSRFIB271) 


e A process attempted to open the indicated tape file. However, the TAPEMANAGER 
system library specified that this open request should be terminated with an open 
error. 


e Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


- MT<unit number> BACKSPACE FAILED TO REACH TAPEMARK 
<file name> (MSRLM27) 


e The library maintenance procedure was unable to recopy or compare a disk file ona 
library maintenance tape because the procedure was unable to locate a tape mark. 
If the error occurred on an input source tape, the procedure discontinues copying 
files. If the error occurred on a destination tape, the procedure discontinues 
copying files to the affected tape. 


@ Resubmit the WFL COPY or ARCHIVE statement on a different tape volume or 
tape drive. 


MT<unit number> BAD DISK HEADER ON TAPE <file name>. 
(MSRLM12) 


e You attempted to copy a file from tape with the WFL COPY statement. However, 
the disk file header read from the tape was either corrupted or the incorrect size. 
The system discontinued copying files. 

e@ Perform as many of the following steps as necessary: 
~ Clean the tape drive and resubmit the COPY statement. 


~ Ifthe operation fails again, move the tape volume to another tape unit and 
resubmit the COPY statement. 


— Ifthe operation still fails, the problem is likely to be with the tape itself. 
Attempt to investigate how the the tape was created and correct any 
inappropriate characteristics. 
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CANNOT QUIT TAPEMANAGER, CURRENTLY <status> 
(MSRMISC213) 


The variable <status> is one of the following: 


INACTIVE 

LINKING 
TERMINATING 
WAITING TO DELINK 
GOING AWAY 


e@ The TAPEMANAGER is in a state that is invalid fora SEND TM QUIT command 
to be processed. 


e If the status is LINKING, wait for the TAPEMANAGER to become INITIATING or 
ACTIVE and then resubmit the request. In all other cases, the TAPEMANAGER 
will eventually become INACTIVE. 


CANNOT START TAPEMANAGER, CURRENTLY <status> 
(MSRMISC212) 


The variable <status> is one of the following: 


ACTIVE 

LINKING 
INITIALIZING 
TERMINATING 
WAITING TO DELINK 
GOING AWAY 


@ The TAPEMANAGER is currently in a state other than INACTIVE. 
e@ Contact your site’s support personnel or the developer of your TAPEMANAGER 


library to determine why this situation exists. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


DESTROYED VOLUME NOT ADDED IN SCRATCH POOL (MT) 
[<volume family>] (MSRVL19) 


@ While initiating a restart of a program that used the checkpoint facility, the restart 
procedure attempted to release certain volumed tapes as scratch tapes. However, 
these volumed tapes were marked as DESTROYED after the checkpoint was taken. 
The restarting task is unaffected, and the restart process continues. 


@ No action is required. 
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MT<unit number> DISK FILE HEADER VERSION ERROR 
<file name> (MSRLM37) 


e The input tape contains a disk file that was created by a newer version of the 
operating system. The current operating system is unable to copy the file. 


e@ Use the CM (Change MCP) system command to change to the advanced Mark 
release version of the operating system; then resubmit the COPY request. 


MT<unit number> END- OF-FILE READING HDR1 LABEL 
<file name> (MSRLM31) 


@ The library maintenance procedure encountered a tape mark where it expected a 
tape label. The procedure discontinues copying files. 


e Ifthe input tape was created correctly —that is, the library maintenance operation 
that wrote the input tape completed successfully — ‘resubmit the request with a 
different tape drive. 


MT<unit number> ERROR CLOSING TAPE FILE <file name> 
(MSRLM26) 


e During the processing of a WFL COPY or ARCHIVE statement, the system CLOSE 
routine returned an error indication between files. Ifthe error occurred ona 
source tape, the system is unable to copy any more files. If the error occurred on a 
destination tape, the system is unable to copy any more files to that tape. 


e Resubmit the COPY or ARCHIVE statement with a different tape volume or tape 
drive. 


MT<unit number> ERROR OPENING TAPE FILE <file name>. 
(MSRLM29) 


e@ Thesystem OPEN routine either failed to correctly locate an input tape file or it 
failed to correctly allocate an output tape file. The system is unable to copy any 
additional files. 


@ Determine the cause of the open error and resolve that problem. Resubmit the 
COPY request with different tapes or tape drives. 
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MT <unit number> ERROR READING TAPE LABEL <file name> 
(MSRLM21) 


e An /J/O error occurred while the system was reading either a tape HDR1, HDR2, 
EOF1, EOF2, or EOV1 label, or a tape mark in response to a WFL COPY 
statement. The system discontinues copying files. 


e Resubmit the COPY statement with a different tape drive or tape volume. 


MT<unit number> ERROR WRITING TAPE LABEL OR TAPE 
MARK <file name> (MSRLMS8) 


e An I/O error occurred while the system was performing one of the following 
operations: ; 


- Writing a tape HDR1, HDR2, EOF1, EOF2, or EOV1 label with the WFL COPY 
-or ARCHIVE statement 


— Writing a tape mark on the output tape 
The system is unable to copy any additional files. 


@ Resubmit the request on a different tape drive or tape volume. 


MT<unit number> EXPECTED RECORD ID <number> BUT 
WORDS 1&2 OF RECORD = <number> <number> (MSRLM39) 


@ The library maintenance procedure read an incorrect record identifier from the 
tape. The procedure is unable to copy any more files to or from the specified unit. 


e Ifthe procedure follows this message with a “RECOPY REQD” RSVP request, see 
the description of that RSVP request later in this appendix for a discussion of your 
options; enter the response of your choice. 


If appropriate, resubmit the WFL COPY or ARCHIVE statement with a different 
1/O unit. 


<unit identifier> FAMILYOWNER MISMATCH OR SECURITY 
ERROR: <filename> (MSRFOUTS) 


e@ The system has rejected a requested tape operation involving the indicated file on 
the indicated tape drive because one of the following situations exists: 


~- The FAMILYOWNER values on the tape label and in the volume directory do 
not match. . 


— Asecurity error occurred. 
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e Determine the cause of the error, take appropriate corrective measures, and 


resubmit the request. 


FAULT REASON = <fault number> <rcew> (MSRMISC223) 


The variable <fault number> is the number of a fault condition, as follows: 


Fault Number 


Fault Name 

ZERODIVIDE 
EXPONENTOVERFLOW 
EXPONENTUNDERFLOW 
INVALIDINDEX 
INTEGEROVERFLOW 
MEMORYPROTECT 
INVALIDOP 

LOOP 

MEMORYPARITY 
SCANPARITY 
INVALIDADDRESS 
STRINGPROTECT 
PROGRAMMEDOPERATOR 
ASSERTIONFAILURE 
INVALIDPROGRAMWORD 


This message is always preceded by the following RSVP request: 


USER PROCESS FAULTED OR DSED WHILE IN TAPEMANAGER LIBRARY CODE 


This RSVP request is discussed in its respective alphabetical position among the other 
message descriptions in this appendix. 


e@ The indicated fault condition occurred. The return control word (rew) is a pointer 
to the stack history array. 


e@ Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to correct the problem. See Section 5, “TAPEMANAGER Library 
Implementation,” for more information on TAPEMANAGER libraries. 
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FILE <file name> <error category>.. . 


Note: A number of system messages begin with this information, which is 
represented in this appendix by the metatoken <FIB error prefix>. 
See Table A-1, “Metatokens Appearing in Message Listings,” for the 
values the <error category> metatoken can have. 


This appendix lists these messages in alphabetic order according to 
the text that follows the <FIB error prefix> metatoken. For example, 
the complete format of system message MSRFIB271 is: “FILE 

<file name> <error category> ASSIGNMENT STOPPED BY 
TAPEMANAGER <rew>.” 


However, this appendix replaces the “FILE <file name> 

<error category>” information with the <FIB error prefix> 
metatoken. And since this appendix ignores metatokens in 
determining the alphabetic order of messages, MSRFIB271 is 
considered to begin with ASSIGNMENT rather than FILE. Thus, the 
entry for MSRFIB271 appears between the entries for MSRLM92, 
“ARCHIVE BACKUP ENTRY DELETED,” and MSRLM12, “BAD 
DISK HEADER ON TAPE.” 


MT<unit number> FILE NOT VERIFIED <file name> (MSRLMS88) 


e A file that was copied to tape by a WFL COPY or ARCHIVE statement with the 
& VERIFY clause was incorrectly verified. This message is usually preceded 
by other error messages describing the reasons for the failure. The library 
maintenance utility continues with the next file. 


If the file name is unknown to the system, no file name appears in the message. 
Instead, the message includes the file number in the following format: 
FILE # nnn 


To determine the name of the file in question, correlate the file names in VERIFIED 
and NOT VERIFIED messages with the file names that appeared in COPIED or 
NOT COPIED messages. 


e Note the name of the file and any preceding error messages. Decide whether to . 
recopy the file with a different unit or a different tape volume. 
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MT <unit number> FILE TITLE ERROR <file name> (MSRLM11) 


e During a library maintenance COPY operation from tape, the library maintenance 
procedure found that the file title of a file is other than the expected title. The 
operation copies no more files. 


e@ Determine whether the input tape was created correctly by examining the job 
log output generated by the WFL COPY or ARCHIVE statement that originally 
created the tape. Ifthe tape was created correctly, resubmit the request with a 
different tape drive. 


MT<unit number> FILE VERIFIED <filename> (MSRLM86) 
e This message is issued for each output tape file that is successfully copied and 
verified. 


e No action is required. 


HISTORY REASON = <reason>, CAUSE = <cause>, 
TYPE = <type> <rcw> (MSRMISC224) 


The variable <reason> is an integer indicating the specific reason for the abnormal 
termination or suspension of a task. This value corresponds to the value of field [23:08] 
of the HISTORY task attribute and to the HISTORYREASON task attribute value. 


The variable <cause> is an integer indicating the general type of condition that caused 
the task to terminate abnormally or be suspended. This value corresponds to the 
value of field [15:08] of the HISTORY task attribute and to the HISTORYCAUSE task 
attribute value. 
The variable <type> is an integer indicating the type of termination that occurred for 
a process. This value corresponds to the value of field [07:08] of the HISTORY task 
attribute and to the HISTORYTYPE task attribute value. 
This message is always preceded by the following RSVP request: 

USER PROCESS FAULTED OR DSED WHILE IN TAPEMANAGER LIBRARY CODE 


This RSVP request is discussed in its respective alphabetical position among the other 
message descriptions in this appendix. 
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e A process has terminated under the indicated conditions. 


e Assess the process termination conditions; take any indicated corrective measures. 


Note: For information on the HISTORY, HISTORYREASON, 
HISTORYCAUSE, and HISTORYTYPE task attributes, see 
Section 3, “Programming Considerations,” as well as the A Series 
Task Attributes Programming Reference Manual. 


<unit name> <serial number> INVALID DENSITY SPECIFIED 
(MSRDPC96) 


@ While executing a PG (Purge) or SN (Serial Number) system command that 
involved the specified unit, the system encountered a density specification that is 
invalid for that unit. The system purges the tape. 


e@ Reenter the command with one of the following modifications: 
— Include the correct density specification. 


— Omit the density specification entirely. In this case, the density remains 
unchanged by the command. 


MT<unit number> INVALID LIBRARY/MAINT TAPE BLOCKSIZE, 
DEFAULT ASSUMED (MSRLM96) 


@ While reading the header labels for the first file from an input tape, the library 
maintenance procedure determined that the block size recorded in the file header 2 
(HDR2) label is not a valid value for a library maintenance tape. The library 
maintenance procedure assumes the default block size for the type of tape involved 
and attempts to proceed with copying files from the tape. 


@ Review any I/O error messages that preceded this message. If possible, examine 
the log to determine if the tape was originally written correctly by the library 
maintenance or archive process that created it. Take any indicated corrective 
measures. 
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MT <unit number> IO ERROR DURING COMPARE <file name> 
(MSRLM15) 


e@ An I/O error occurred during the COMPARE procedure while the library 
maintenance procedure was reading from a tape unit. 


e Ifthe procedure follows this message with a “RECOPY REQD” RSVP request, see 
the description of that RSVP request later in this appendix for a discussion of your 
options; enter the response of your choice. 


If appropriate, resubmit the WFL COPY or ARCHIVE statement with a different 
tape unit. 


MT <unit number> IO ERROR DURING COPY <file name> 
(MSRLM4) 


e Anerror occurred while the library maintenance procedures was reading or writing 
data to or from the tape unit for the specified file. 


e Ifthe procedure follows this message with a “RECOPY REQD” RSVP request, 
see the description of that request later in this appendix for a discussion of your 
options; enter the response of your choice. 


If appropriate, resubmit the WFL COPY or ARCHIVE statement with a different 
1/O unit. 


MT<unit number> I/O ERROR ON CHECKSUM RECORD 
<file name> (MSRLM84) 


@ An /J/O error occurred when the library maintenance procedure read the checksum 
of a file from a tape or wrote the checksum of a file to a tape during the initiation of 
a WFL COPY, ADD, or ARCHIVE statement with the & VERIFY clause. 


@ Note the name of the file and the preceding I/O logical result descriptor error 
message. Decide whether to copy the file again using a different unit or a different 
tape volume. 


MT<unit number> I/O ERROR READING HDR1 LABEL 
<file name> (MSRLM30) 


e@ An/I/O error occurred while the library maintenance procedure was reading a tape 
label from an input tape. The affected file is not copied. 
e@ Ifthe input tape is damaged or was created incorrectly, the system is unable to copy 


the affected file. Otherwise, resubmit the WFL COPY or ARCHIVE statement 
with a different tape drive. 
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I/O ERROR WHILE ACCESSING GUARDFILE <file name> <rcw> 
(MSRMISC201) 


e An//O error occurred while the system was attempting to access the indicated 
guard file. 


@ Determine the cause of the I/O error, correct that problem, and resubmit the 
request. , 


<FIB error prefix> LIBRARY CANNOT OPEN THIS FILE <rew> 
(MSRFIB270) 


@e The TAPEMANAGER library has attempted to open a file for which an OPEN 
request is already underway. 


@ Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to correct the problem. See Section 5, “TAPEMANAGER Library 
Implementation,” for more information on TAPEMANAGER libraries. 


NEED AN OUTPUT TAPE FOR OUMT (MSRFOUT11) 


@ The system rejected your response to an RSVP request. You entered an OU 
(Output Unit) system command in the form 
OU MT | 
However, no suitable tape is available. 


e@ Load a scratch tape and ready it with an RY (Ready) system command. Then 
reissue the OU command. 


MT<unit number> NEW SOURCE UNIT OR VOLUME IS 
RESTRICTED (MSRLM42) 


e During a file copy operation from tape, a reel switch occurred on the source file. 
The new file has been named in a RESTRICT (Restrict Unit or Volume) system 
command to indicate that it is a “hazardous” file. A hazardous file is one that has 
the potential to compromise the security of the system. 


After this message, the following RSVP request appears: © 


UNRESTRICT SOURCE AND REPLY OK TO COPY <file name> 
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This RSVP request is discussed in its respective alphabetical position among the 
other message descriptions in this appendix. 


The system waits for your response. 


@ Review the options and take the action of your choice. 


NO CATALOG ACTION (LIBRARY TAPE) (MT) <file name> 
(MSRCAT16) | : 


e@ You attempted to execute a WFL CATALOG DELETE statement on a tape file that 
is located on a library maintenance tape. Library maintenance tape files are never 
cataloged. 


@ No action is required. 


<unit identifier> NO ENTRY FOR VOLUME IN ’VOLUME 
DIRECTORY’: <file name> (MSRFOUT15) 


e@ The system is unable to find an entry in the volume directory for the indicated 
volume. 


e@ Determine whether the request specified the correct volume name. Resubmit the 
request with a corrected name if appropriate. 


MT<unit number> NO RECOPY WHEN USING THIS KIND OF 
TAPE <file name> (MSRLM69)_. 


@ Kither the source or the destination volume does not support the RECOPY option. 
The library maintenance procedure continues to copy that file to other destinations 
as required. The procedure then copies the remaining files as required. 


e@ Note the original error message and the name of the file that was copied. Decide 
whether to resubmit the copy request to retry the operation that failed. 
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NOT A SCRATCH VOLUME <volume name> (<kind>) 
[<serial number>] (MSRVL16) 


@ You entered one of the WFL statements VOLUME DELETE SCRATCH or 
VOLUME DESTROY SCRATCH, but the volume you specified is not listed as 
SCRATCH in the volume library. The system rejects the request, and the job 
continues. 


Note: When you ready a tape volume containing an expired tape file and 
enter the PER MT form of the PER (Peripheral Status) system 
command, the system displays the volume as a scratch tape. 
However, the volume library entry for expired tape files still uses the 
original volume name rather than the name SCRATCH. 


e Display the status of the volume by entering a PV (Print Volume) system command. 
Then resubmit the VOLUME DELETE statement with the correct information. 


<FIB error prefix> NOT CLOSED <rcw> (MSRFIB74) 


e A program attempted to open the indicated file or a subfile of that file, but one of 
the following situations exists: 


— The file or subfile is a port file that has a FILESTATE attribute value other 
than CLOSED. 


— The file or subfile is a nonport file that is already open. 


@ Make appropriate corrections to the program. 


<unit name> MT <unit number> PURGE REQUEST REJECTED 
BY TAPEMANAGER (MSRDPC177) 


@ The TAPEMANAGER library rejected a request to purge the indicated tape. The 
message includes the name and number of the unit if those values are available; 
the message lists a null value for any unavailable value. 


e Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


MT<unit number> RECOPY REQD <file name> (MSRLM5) 


@ This RSVP request is preceded by a library maintenance error message. Only some 
error conditions allow recopying, such as those indicated by the following messages: 


TQ ERROR DURING COPY 
COMPARE ERROR 
I/O ERROR DURING COMPARE 
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Descriptions of these messages appear in their respective alphabetical positions 
among the other system message descriptions in this manual. 


e@ The variable <unit number> refers to a specific destination because files can be 
copied to several destinations at the same time. Enter one of the following system 
commands:, 


— <mix number> DS 


Terminates the library maintenance operation. Any files already copied 
remain, but the file in question and any other files that were to be copied are 
not copied. 


— <mix number> OF 


Prevents the file from being recopied. The library maintenance procedure 
continues with the next file. 


— <mix number> FR 


Prevents any more files from being copied to this destination. If there are no 
other destinations, the library maintenance program terminates; otherwise, it 
continues copying to the other specified destinations. 


— <mix number> OK 


Permits the file to be recopied. Ifthe error persists, the library maintenance 
operation repeats the error message and asks again whether the file should be 
recopied. 


MT<unit number> RECORD par ERROR <file name> 
(MSRLM7) 


e@ During the execution of a WFL COPY statement, the sequence indicator read from 
the tape was either incorrect or out of sequence. If this error occurs while the 
library maintenance procedure is reading the source tape directory, the procedure 
discontinues copying files. If this error occurs while the procedure is reading the 
disk file header record from the source tape, the procedure does not copy that 
file. Ifa sequence error occurs while the procedure is reading data records from — 
the source or destination tape, the procedure issues a “RECOPY REQD” RSVP 
request. 


e If“RECOPY REQD” appears, see the description of that RSVP request earlier in 
this appendix for a discussion of your options and enter the response of your 
choice. Or, copy the file from another tape drive. If the problem persists for a 
particular input tape, the tape was probably created incorrectly or was permanently 
damaged. 
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<FIB error prefix> REOPEN STOPPED BY TAPEMANAGER 
<rew> (MSRFIB268) 


e A process attempted to open a tape file that was previously opened and closed with 
retention. However, the TAPEMANAGER system library specified that this open 
request should be terminated with an open error. 


e Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


<file name> REQUIRES <unit identifier> (MSRFOUTS30) 


@ The MCP is unable to perform a requested file assignment because it cannot locate 
a unit that matches the selection attributes of the named output file. The system 
waits for your response. 

e Enter one of the following system commands: 

— <mix number> OK 
Attempts again to locate a unit for file assignment. 
— <mix number> FA <file attribute> = <value> 


Updates the specified attribute value for the file and then attempts again to 
locate a unit for file assignment. 


— <mix number> OU <unit number> 
Directs output from the task to the specified unit. 
- <mix number> DS 


Terminates the process. 


MT<unit number> REQUIRES VOLUME DELETE (MSRDPC93) 


e@ You issued an SN (Serial Number) system command in the following form: 


SN MT<unit number> [<serial number>] 


The system rejected this command because changing the serial numbers of 
volumed tapes —that is, tapes listed in the volume library — with the SN command 
is disallowed. The tape volume that is to be purged is listed in the volume library 
under its current serial number. The tape is not purged. 


e@ Determine ifthe serial number of the selected volume must be changed. Ifso, enter 
a WFL VOLUME DELETE statement for the selected volume. Then reissue the 
SN command. After the SN command completes, enter a WFL VOLUME ADD 
statement for the new scratch tape family so that it isa volumed tape. 
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RESTART ABORTED: TAPE LABELKIND CONFLICTS WITH 
USAGE (MSRRS26) 7 


@ This error occurs during a RERUN operation from a checkpoint. The assigned 
tape volume has a LABELKIND value that indicates that it is structured for use 
only with A Series system procedures, such as library maintenance. The system 
prevents user programs from altering the data on such system tapes. (User 
programs can erase and write ordinary data files on system tapes, but the programs 
must open the file as a new file starting at the beginning of the tape volume.) 


The system closes the tape and discontinues the process. As a result of this action, 
that tape volume is likely to be unusable as input to system programs. 


e@ Locate the tape volume that was used by the program when the checkpoint was 
originally taken, place it online, and rerun the job. 


MT<unit number> SCRATCHPOOL REJECTED BY 
TAPEMANAGER (MSRDPC183) 


e During the execution of a PG (Purge) or SN (Serial Number) system command, 
the TAPEMANAGER library rejected the scratchpool value for the indicated unit. 
The message includes the unit number if that value is available. The tape is not 
purged. 


@ Contact your site’s support personnel or the developer of your TAPEMAN. AGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


MT<unit number> SECURITYLABELS REQUIRE ANSI87 LABELS 
BUT OPTION ISNT SET (MSRSOFT42) 


@ A new tape volume is being created on the tape that is mounted on the indicated 
unit. The SECURITYLABELS volume attribute is set for the tape. However, 
neither of the following specifications has been used to specify that ANSI87 labels 
are to be written: 


- LABELFORMAT system option 
— LABELFORMAT task attribute 
The system creates the volume with ANSI87 labels. 


e If ANSI87 labels are acceptable, no action is required. If ANSI87 labels are not 
acceptable, reset the SECURITYLABELS volume attribute and re-create the tape. 
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MT<unit number> SERIAL NUMBER REJECTED BY 
TAPEMANAGER (MSRDPC181) 


e During the execution of a PG (Purge) or SN (Serial Number) system command, the 
TAPEMANAGER library rejected the serial number value for the indicated unit. 
The message includes the unit number if that value is available. The tape is not 
purged. 


e Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


MT<unit number> SERIALNO MATCHES BUT TAPE 
IS A LIBRARY/MAINTENANCE TAPE <file name> 
<volume description> (MSRCAT26) 


e This warning message can appear while the system is processing a WFL 
CATALOG ADD statement. The system located an online tape with a serial 
number that matches the serial number specified in the statement, but the online 
tape is a library maintenance tape. Only tape files on tapes that are other than 
library maintenance tapes can be marked as cataloged. The system continues 
looking for another online tape that properly matches the request. 


e Ifthe system is unable to locate another online tape that matches the request, 
verify that the statement was issued with the correct serial number, tape name, 
cycle, and version specifications. If you specified them incorrectly, reissue the 
request with the correct values. If you specified them correctly, verify that the 
correct tape volume is online and resubmit the CATALOG ADD request. 


MT<unit number> SERIALNO MATCHES BUT TAPE IS NOT 
FIRST REEL <file name> <volume description> (MSRCAT27) 


e@ This message can appear while the system processes a WFL CATALOG ADD 
statement. The system located an online tape with a serial number that matches 
the serial number specified in the statement, but the online tape belongs to a 
multivolume tape set and the online tape is other than the first tape of that set. 
The system continues looking for another online tape that properly matches the 
request. 


e Ifthe system is unable to locate another online tape that matches the request, 
verify that you issued the statement with the correct serial number, tape name, 
cycle, and version specifications. If you specified them incorrectly, resubmit the 
request with the correct values. If you specified them correctly, verify that the 
correct tape volume is online and resubmit the CATALOG ADD request. 
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<unit number> SERIALNO MATCHES BUT TAPE IS NOT LISTED 
IN VOLUME LIBRARY <file name> <volume description> 
(MSRCAT9) 


@ The message can appear while the system processes a WFL CATALOG ADD 
statement. The system has located an online tape with a serial number that 
matches the serial number specified in the request, but that tape volume has no 
entry in the system’s volume library. The system continues looking for another 
online tape that matches the name and serial number in the CATALOG ADD 
statement and that has an entry in the volume library. 


e Ifthe system is unable to locate another online tape that matches the request, 
verify that you issued the CATALOG ADD statement with the correct serial 
number, tape name, cycle, and version specifications. If you specified them 
incorrectly, resubmit the request with the correct values. If you specified them 
correctly, verify that the correct tape volume is online and, if necessary, submit 
a WFL VOLUME ADD statement for that tape volume. Then resubmit the 
CATALOG ADD request. 


MT<unit number> SERIALNO MISMATCH, ‘COPY & VERIFY’ 
TERMINATED (MSRLM85) 


@ The system was unable to identify the tape volume that the library maintenance 
procedure was verifying as a result of the VERIFY option. After copying files to 
the tape, the library maintenance procedure rewound the tape to read and verify 
the copied files. However, the serial number on the tape volume label does not 
match the serial number of the volume to which the files were written. As a result, 
the system is unable to verify the files for the specified destination. 

e@ Determine whether one of the following situations caused the mismatch: 

— An I/O error occurred during the rewind operation. 
— An TJ/O error occurred when the label was read. 


— The tape volume was manually unloaded and replaced between the copy and 
verify phases. 


Decide if the copy and verify process should be repeated. 


SOURCE TAPE <tape name> MISSING (MSRLM90) 


e The library maintenance procedure failed to open the named source tape for input 
because one of the following situations exists: 


~ You replied to the “NO FILE” RSVP request with the OF (Optional File) 
system command. 


- Anerror occurred while the tape directory file on the tape was being opened. 
The utility proceeds to copy from other sources, if any. 
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@ Determine why the utility was unable to correctly open the source tape. If 
necessary, resubmit the copy request with the correct input tapes. 


TAPE ABANDON FILEHANDLER, TYPE= <action> <file name> 
<file name> (MSRDIR1) 


_ The variable <action> is one of the following: 


AUDIT RECOVER 
ENTER 

ENTER BACKUP 
PDSEARCH 
REMOVE 

SEARCH 
TIMESTAMP 
UPDATE 


e@ Anerror occurred during an attempt to perform the specified operation on the 
catalog record for a cataloged tape file on a cataloging system. The system 
discontinues the operation and returns an error indication to the calling program. 


@ Note the error and correlate it with preceding directory error messages. Ifa 
particular program repeatedly encounters directory errors, consider discontinuing 
the program with the DS (Discontinue) system command. 


MT<unit number> TAPE DIRECTORY COMPARE ERROR 
(MSRLM17) 


@ During the execution of a WFL COPY or ARCHIVE statement, the system 
found that the tape directory read from the specified destination differs from the 
information that was written to the tape. The library maintenance procedure 
discontinues copying files to that destination tape. | 


@ Resubmit-the COPY or ARCHIVE statement with a different tape drive or a 
different tape volume. 


‘<host name>’ TAPE DIRECTORY READ ERROR (MSRLMO) 


e@ An error occurred while the library maintenance procedure was sending the list of 
file names to be copied from one host to another. The system copies no files for this 
request. 


@ Resubmit the request. 
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MT<unit number> TAPE DIRECTORY READ ERROR (MSRLMO) 


e An//O error occurred while the library maintenance procedure was reading the 
list of file names from the tape volume. If the tape is an input tape, the procedure 
discontinues copying files. If the tape is an output tape and the read error occurred 
while the system was comparing directories, the procedure discontinues copying 
files to that tape. 


In most cases, the procedure discontinues copying files to the tape, but if the failing 
tape was started after a reel switch, the beginning of the tape contains the last part 
of the file that spanned two reels. 


e Kither resubmit the WEL COPY or ARCHIVE statement, or move the tape to 
another tape drive and then resubmit the statement. 


‘<host name>’ TAPE DIRECTORY WRITE ERROR (MSRLM1) 


e The library maintenance procedure was unable to copy files to another host system 
because an error occurred when the procedure was writing the tape directory. The 
procedure discontinues copying files for this request. 


e Resubmit the WFL COPY statement. 


MT<unit number> TAPE DIRECTORY WRITE ERROR (MSRLM1) 


e@ The library maintenance procedure was unable to copy a file to tape because an I/O 
error occurred when the procedure was sending the list of file names to the tape 
volume. The procedure discontinues copying files to that tape. 


@ Resubmit the WFL COPY or ARCHIVE statement with a different tape volume or 
tape drive. 


‘<host name>’ TAPE DISKHEADER READ ERROR <file name> 
(MSRLM2) 


e@ The library maintenance procedure was unable to copy a file from another host 
system because an error occurred while the procedure was receiving the disk file 
header for a file. 


@ Note the file name and resubmit the WFL COPY statement. 
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MT<unit number> TAPE DISKHEADER READ ERROR 
<file name> (MSRLM2) 


e@ The library maintenance procedure was unable to copy a file to or from the tape 
because an I/O error occurred while the procedure was reading the disk file header 
from the tape. 


@ Move the tape to another tape drive and resubmit the WFL COPY or ARCHIVE 
statement. 


MT<unit number> TAPE DISKHEADER WRITE ERROR 
<filename> (MSRLMS3) 


@ The library maintenance procedure was unable to copy a file to or from tape 
because an I/O error occurred while the procedure was writing the disk file header 
to tape. | 


@ Move the tape to another tape drive and resubmit the WFL COPY or ARCHIVE 
statement. 


MT<unit number> TAPE FILE MISSING <file name> (MSRLM34) 


@ The library maintenance procedure was unable to locate the specified file on the 
input tape. The procedure discontinues copying files. 


e Ifthe input tape was created incorrectly or is damaged, the system is unable to 
copy the affected file. Otherwise, resubmit the request on a different tape drive. 


MT<unit number> TAPE POSITIONING ERROR <file name> 
(MSRLM6) 


e An I/O error occurred in one of the following situations: 


— The library maintenance procedure was spacing an input tape forward to locate 
the next file to be copied. 


In this case, the procedure continues to attempt copying files. 


— The library maintenance procedure has backspaced after backspacing a tape 
for a compare or recopy operation. 


In this case, the procedure discontinues copying files to or from that tape. 


@ Resubmit the WFL COPY or ARCHIVE statement on a different tape drive or tape 
volume. 
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(<mix number>) TAPE READ <record type> <error code> ERROR 
-REC=<number> (MSREHO0) 


The variable <record type> is one of the following: 


CAT 
FAST 
FLAT 
PAST 
VAST 
VOLLIB 


The variable <error code> is one of the following: 


CHECKSUM 
HDRBLOCKLENGTH 
HDRLOCATION 
HDRMARKER 

NOT READY 
TITLE 

UNKNOWN 


@ A hardware, software, or data error occurred while the system was reading a 
catalog for a cataloged tape file. The variable <number> indicates the record 


number of the directory record that encountered the error. 


@ Note the error so you can correlate it with any other problems. 


MT <unit number> TAPE WILL BE PURGED (MSRLM81) 


e The system displayed the RSVP request 


MT<unit number> VERIFY ERROR; REPLY 'OF' TO CONTINUE WITH 
NEXT FILE, 'FR' TO PURGE TAPE <file name> 


In response, you entered a FR (Final Reel) system command in the following form: 
<mix number>FR 


e Resubmit the original WFL COPY & VERIFY statement with different tape units 
or tape volumes. 
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(<mix number>) TAPE WRITE <record type> <error code> 
ERROR REC=<number> (MSREHO) 


The variable <record type> is one of the following: 


CAT 
FAST 
FLAT 
PAST 
VAST 
VOLLIB 
UNKNOWN 


The variable <error code> is one of the following: 


CHECKSUM 
HDRBLOCKLENGTH 
HDRLOCATION 
HDRMARKER 

NOT READY 
TITLE 

UNKNOWN 


e A hardware, software, or data error occurred while the system was updating a 
catalog for a cataloged tape file. The variable <number> indicates the record 
number of the directory record that encountered the error. 


@ Note the error so you can correlate it with any other problems. 


TAPEMANAGER FAILED IN INITIALIZATION PROCEDURE 
(MSRMISC214) 


e ASEND TM START request has been entered. However, the TAPEMANAGER 
library procedure CONTROL _ INTERFACE encountered an error. 
e@ Contact your site’s support. personnel or the developer of your TAPEMANAGER 


library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 
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TAPEMANAGER FAILED IN TERMINATION PROCEDURE 
(MSRMISC215) 


A SEND TM QUIT system command has been entered. However, the 
TAPEMANAGER library procedure CONTROL_INTERFACE encountered an 
error. 


Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to determine why the request was denied. See Section 5, “TAPEMANAGER 
Library Implementation,” for more information on TAPEMANAGER libraries. 


TAPEMANAGER IS ACTIVE (MSRMISC207) 


The system has activated the TAPEMANAGER in response to a SEND TM START 
system command. 


No action is required. 


TAPEMANAGER IS INACTIVE (MSRMISC211) 


The system has deactivated the TAPEMANAGER in response to a SEND TM 
QUIT system command. 


After displaying this message, the system displays the following message: 


TAPEMANAGER LIBRARY WILL NOT BE USED 


This message is described in its respective alphabetical position among the other 
message descriptions in this appendix. 


No action is required. 


TAPEMANAGER LIBRARY HAS LINKED (MSRMISC206) 


A-26 


The system has successfully linked to the TAPEMANAGER library. 


No action is required. 


8600 0940-000 


System Messages 


TAPEMANAGER LIBRARY IS ALREADY ACTIVE (MSRMISC222) 


e The system has rejected a SEND TM START system command because the current 
TAPEMANAGER library is already active. Previously, however, the status of the 
library had been INACTIVE. 


e Contact your site’s support personnel or the developer of your TAPEMANAGER 
library to correct the problem. See Section 5, “TAPEMANAGER Library 
Implementation,” for more information on TAPEMANAGER libraries. 


TAPEMANAGER LIBRARY IS MISSING CONTROL_INTERFACE 
PROCEDURE (MSRMISC210) : 


e This message is preceded by the following message: 


WARNING: TAPEMANAGER LIBRARY IS MISSING ONE OR MORE OBJECTS 


The third message to appear in the sequence is the following: 


TAPEMANAGER LIBRARY WILL NOT BE USED 


Descriptions of the additional messages appear in their respective phevee 
positions among the other descriptions in this appendix. 


A SEND TM START system command has been entered. However, the MCP 
has determined that the CONTROL_ INTERFACE procedure and perhaps 
other standard TAPEMANAGER procedures have not been exported from the 
TAPEMANAGER library. 


Startup of the TAPEMANAGER library is stopped. 


@ Determine whether the proper code file was named in the SL (Support Library) 
system command that was used to install the TAPEMANAGER library. If 
necessary, reissue the SL command with the correct code file name and resubmit 
the SEND TM START request. Check with the developer of the TAPEMANAGER 
library to verify that the proper entry points have been exported. See Section 5, 
“TAPEMANAGER Library Implementation,” for more information on 
TAPEMANAGER libraries. 


TAPEMANAGER LIBRARY WILL NOT BE USED (MSRMISC208) 


e@ This message is preceded by the following messages: 


WARNING: TAPEMANAGER LIBRARY IS MISSING ONE OR MORE OBJECTS 
TAPEMANAGER IS MISSING CONTROL_INTERFACE PROCEDURE 
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Descriptions of these messages appear in their respective alphabetical positions 
among the other system message descriptions in this manual. 


The CONTROL_INTERFACE procedure and perhaps other standard 
TAPEMANAGER procedures have not been exported from the TAPEMANAGER 
library. When CONTROL _ INTERFACE is missing, the MCP makes no use of the 
TAPEMANAGER library. 


Determine whether the proper code file was named in the SL (Support Library) 
system command that was used to install the TAPEMANAGER library. If 
necessary, reissue the SL command with the correct code file name and resubmit 
the SEND TM START request. Check with the developer of the TAPEMANAGER 
library to verify that the proper entry points have been exported. See Section 5, 
“TAPEMANAGER Library Implementation,” for more information on 
TAPEMANAGER libraries. 


TAPEMANAGER REQUIRED (MSRMISC220) 


e A task that requires interaction with the TAPEMANAGER library cannot continue 


because the TAPEMANAGER library is not currently active. The system waits for 
your response. 


e Determine why the TAPEMANAGER library is not active. Then choose one of the 


following courses of action: 


~ Initiate the library by entering a SEND TM START system command. Once 
the library is active, the waiting task continues automatically. 


— Enter one of the following system commands: 
o  <mix number> OK 


Retries the call to the TAPEMANAGER library. This option is likely to 
produce the same result. 


o  <mix number> OF 


Bypasses the call to the TAPEMANAGER library. Unisys does not 
recommend this option because it can also bypass security measures 
defined by your site. 


o  <mix number> DS 


Terminates the task. 


MT<unit number> TITLE FOUND WAS: <file name> (MSRLM24) 


The disk file title that the library maintenance procedure located on the tape differs 
from the expected file title. 


If the tape was created correctly, resubmit the WFL COPY or ARCHIVE statement 
with a different tape drive. 
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<unit identifier> TYPE DISAGREES WITH KIND, REQUIRES 
<unit kind> (MSRFOUT23) 


e The system rejected a request to open a file on the indicated unit because the type 
of unit does not match the KIND specified for the task. The system waits for your 
response. , 

e Enter one of the following system commands: 
~ <mix number> OK 

Attempts again to open the file. 
- <mix number> FA <file attribute> = <value> 


Assigns the specified attribute value to the file and then attempts to open the 
file. 


—- <mix number> OU <unit number> 
Directs output from the task to a unit of the required kind. 
— <mix number> DS 


Terminates the process. 


UNABLE TO LINK TO TAPEMANAGER LIBRARY (MSRMISC205) 


e ASEND TM START system command has been entered, but the system is 
unable to link to the TAPEMANAGER library. Library linkage can failifthe 
TAPEMANAGER function is not defined, if the library code file is missing or is 
not a library, or for other reasons. The system stops the attempt to link to the 
TAPEMANAGER library. 


@ Determine whether the proper code file was named in the SL (Support Library) 
system command that was used to install the TAPEMANAGER library. If 
necessary, reissue the SL command with the correct code file name and resubmit 
the SEND TM START request. Check with the developer of the TAPEMANAGER 
library to verify that the proper entry points have been exported. See Section 5, 
“TAPEMANAGER Library Implementation,” for more information on 
TAPEMANAGER libraries. 
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UNABLE TO LINK TO TAPEMANAGER LIBRARY. ENTER OK TO 
RETRY (MSRMISC204) 


@ ASEND TM START system command has been entered, but the system is 
unable to link to the TAPEMANAGER library. Library linkage can fail if the 
TAPEMANAGER function is not defined, if the library code file is missing or is 
not a library, or for other reasons. The system stops the attempt to link to the 
TAPEMANAGER library and waits for your response. 


® Determine the cause of the error and decide whether corrective measures are 
possible. For example, you might be able to copy a corrected version of the library 
to its intended location. 


Then enter one of the following system commands: 
— <mix number> OK 

Retries the linkage operation. 
— <mix number> DS 


Terminates the operation. 


MT <unit number> UNEXPECTED TAPE MARK - NOT COPIED 
<file name> (MSRLM22) 


e Library maintenance detected an end-of-file (EOF) marker in the middle of the 
data portion of the input tape file. 


e Ifthe tape was created correctly, resubmit the WFL COPY or ARCHIVE statement 
on a different tape drive. 


UNIT NOT VOLUMED ON MT<unit number> TAPE<number> 
(MSRCAT11) 


e A process attempted to mark a tape file as cataloged, but the volume library 
contains no listing for the volume on which the file is located. 


e Ifthe tape should be volumed, use the WFL VOLUME ADD statement to add the 
volume to the volume library. 


MT<unit number> UNRESTRICT SOURCE AND REPLY OK TO 
COPY <file name> (MSRLM43) 


e This request is preceded by the following message: 


NEW SOURCE UNIT OR VOLUME IS RESTRICTED 
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This message is discussed in its respective alphabetical position among the other 
message descriptions in this appendix. 


During a file copy operation from a tape, a reel switch occurred on the source file. 
The new file has been named in a RESTRICT (Restrict Unit or Volume) system 
command to indicate that it is a “hazardous” file. A hazardous file is one that has 
the potential to compromise the security of the system. 


The system waits for your response. 


e@ Take one of the following courses of action: 
— Discontinue the job by entering a DS (Discontinue) system command. 


- Remove the restriction on the source unit or volume. Then respond to the 
RSVP request with an OK (Reactivate) system command to continue the 
operation. . 


USER PROCESS FAULTED OR DSED WHILE IN TAPEMANAGER 
LIBRARY CODE (MSRMISC221) 


@ While a task was performing a tape operation — opening a tape file, purging a 
tape, or calling the programmatic interface to the TAPEMANAGER library, for 
example — one of the following situations arose: 


— A fault occurred. 


— Thesystem discontinued the process in response to a DS (Discontinue) system 
command. The job remains in the mix display only if the TAPEMANAGER 
library was discontinued for one of reasons associated with the following 
history task attribute values: 


HISTORYTYPE HISTORYCAUSE HISTORYCAUSE 

4 (DSEDV) 1 (OPERATORCAUSEV) 2 (JUSTDSEDV) 

4 (DSEDV) 1 (PROGRAMCAUSEV) | 18 (DEATHINFAMILY) 
4 (DSEDV) 1 (PROGRAMCAUSEV) 125 (DATABASEDIEDV) 
4 (DSEDV) 1 (PROGRAMCAUSEV) 126 (LIBRARYDIEDY) - 


If the TAPEMANAGER library was discontinued for any of these reasons, the 
system then displays one of the following messages: 


FAULT REASON = <fault number> <rcw> 


HISTORY REASON = <reason>, CAUSE = <cause>, TYPE = <type> <rcw> 


These messages are described in their respective alphabetic positions among the 
other message descriptions in this appendix. 


The system waits for your response to the RSVP request. 
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e Ifthe TAPEMANAGER library was discontinued for one of reasons just listed, 
contact your site’s support personnel or the developer of your TAPEMANAGER 
library to correct the problem. See Section 5, “TAPEMANAGER Library 
Implementation,” for more information on TAPEMANAGER libraries. 


If the library was discontinued for another reason, enter one of the following 
system commands: 


— <mix number> OK 
Retries the operation. 
— <mix number> OF 
7 Bypasses the operation. 
— <mix number> DS 


Terminates the task. 


MT <unit number> VERIFY ERROR; REPLY ’OF’ TO CONTINUE 
WITH NEXT FILE, ’FR’ TO PURGE TAPE <file name> (MSRLM79) 


e An error occurred during a library maintenance file copy and verify operation. A 
message describing the specific error preceded this message. 


The system waits for your response. 
Note: In many cases, an error that occurs during the verify phase is the 
result of an error in the copy phase. 


If your installation performs cataloging, be aware that if the COPY statement 
included the BACKUP option, the catalog already contains entries for all the 
cataloged files that were copied. Even though an error occurred during the verify 
phase, and even if you purge the tape, the catalog still contains backup references 
to the tape for all the files that were copied. 


@ Enter one of the following system commands: 


— <mix number> FR 


Terminates the copy and verify process to the failing tape destination. Copying 
to other destinations, if any, continues. The failed tape is automatically 
rewound and purged. Retry the original copy and verify process with different 
media or units. 


— <mix number> OF 


Causes the library maintenance procedure to skip to the next file. Although 
the file reported in error remains on the tape, it was copied incorrectly to the 
tape. 


— <mix number> DS 
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Terminates the copy process immediately, leaving the invalid output tape 
intact. Subsequently, purge the tape with the PG (Purge) system command. 
Then reissue the COPY or VERIFY command with the & VERIFY clause with 
different media or units. You can also attempt to copy files from the tape even 
though some of the files might have been copied incorrectly to the tape. 


VOLUME DIRECTORY <vol dir extension> <family name> 
{<serial number list>] <error condition> 


The variable <error condition> is one of the following: 


DUPLICATE SERIAL NUMBER (MSRVS7) 

FAMILY AND NAME MISMATCH (MSRVS11) 

FAMILYOWNER CONFLICTS WITH TASK USERCODE (MSRVS21) 

NOT DONE--NOT PERMANENTLYOWNED WITH SECURITYLABELS (MSRVS23) 

NOT DONE--ONLY 1 SERIAL NUMBER WITH MATCHONLYSERIALNUMBER (MSRVS22) 
NOT DONE--SECURITYGUARD HAS TO BE A GUARDFILE (MSRVS2@) 
REPEATED SERIAL NUMBER (MSRVS6) 

SERIAL NUMBERS NOT IN SAME FAMILY (MSRVS1@) 

SERIALNO IS MISSING FROM DATA RECORD (MSRVS19) 

VOLUME IS OWNED BY ANOTHER USER (MSRVS18) 

VOLUME NAME CONFLICTS WITH VOLUME DIRECTORY ENTRY (MSRVS12) 

WON'T FIT IN VOLUME DIRECTORY (MSRVS9) 


e The system encountered the indicated problem with the volume directory of the 
indicated family while attempting to perform the indicated action. 


e Correct the indicated error condition and resubmit the request. 


VOLUME DIRECTORY MT<unit number> <vol dir extension> 
<family name> [<serial number list>] <error condition> 


The variable <error condition> is one of the following: 


INVALID SERIAL NUMBER (MSRVS17) 

LABELS CONFLICT WITH VOLUME DIRECTORY ENTRY (MSRVS13) 
MISSING SERIAL NUMBER (MSRVS8) 

SERIALNO IS MISSING FROM DATA RECORD (MSRVS19) 

VOLUME NAME CONFLICTS WITH VOLUME DIRECTORY ENTRY (MSRVS12) 
WARNING VOLUME NAME CONFLICTS WITH ONLINE VOLUME (MSRVS15) 


e The system encountered the indicated problem with the volume directory of the 
indicated unit. 


e Correct the indicated error condition and resubmit the request. 
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VOLUME DIRECTORY MT<unit number> <family name> 
[<serial number list>] DISK ERROR <operation> 


The variable <operation> is one of the following: 


DISK ERROR READING DATA BLOCK (MSRVS4) 
DISK ERROR READING KEY BLOCK (MSRVS2) 
DISK ERROR WRITING DATA BLOCK (MSRVS5) 
DISK ERROR WRITING KEY BLOCK (MSRVS3) 


e A disk error occurred while the system was attempting to perform the indicated 
operation on the indicated unit. 


@ Correct the indicated error condition and resubmit the request. 


VOLUME DIRECTORY MT<unit number> <vol dir extension> 
<family name> [<serial number list>] FAULT IN VSHANDLER 
<rew> (MSRVS1) | 


e@ The operating system volume directory procedure VSHANDLER encountered a 
fault interrupt at the location in the MCP code indicated by the variable <rew>. 


@ Note the error If the problem persists, isolate the program or programs or the 
tape volume or volumes that encountered the problem. Notify your Unisys field 
engineer. Make a copy of the SYSTEM/CATALOG/nnn or SYSTEM/ACCESS/nnn 
file so that any problems caused by corrupted volume directory data structures can 
be investigated by the field engineer. 


VOLUME DIRECTORY MT<unit number> <vol dir extension> 
<family name> [<serial number list>] RECORD HAS INVALID 
DATA IN WORD <rcew> (MSRVS14) 


@ While processing a record, the system encountered invalid data in the word at the 
location indicated by the variable <rew>. 


e Correct the invalid data at the indicated location. 
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VOLUME DIRECTORY MT<unit number> <family name> 
[<serial number list>] NOT SNED, REQUIRES VOLUME DELETE 
(MSRVS16) . 


@ The system is unable to perform a requested SN (Serial Number) operation on the 
indicated tape volume directory. 


e@ Verify that the unit number and the serial number are correct. Then specify the 
unit number in the following sequence of commands: 
- VOLUME DELETE 
- SN 
- VOLUME ADD 


VOLUME DIRECTORY VOLUME ADD <family name> 
[<serial number or serial number list>] NOT DONE —- NOT 
PERMANENTLYOWNED WITH SECURITYLABELS (MSRVS23) 


@ The system is unable to add a volume entry to the indicated volume directory 
as requested because the operation attempted to set the values of both the 
SECURITYLABELS and PERMANENTLYOWNED attributes to TRUE. 


e Enter a request that specifies that either SECURITYLABELS or 
PERMANENTLYOWNED — but not both —is to be set to TRUE. 


VOLUME FAMILY <volume family> NOT DELETED (TAPE IN 
USE) (MSRVL12) 


e AWEL process attempted to execute a VOLUME DELETE or VOLUME DESTROY 
statement for a tape volume that isin use. The system ignores the command and 
continues to execute the process issuing the request. 


@ Wait for the job using the tape to close the tape file. Then resubmit the request. 


MT<unit number> WARNING, TAPE WAS NOT WRITTEN WITH 
CHECKSUMS <tape name> (MSRLM82) 


e Alibrary maintenance process initiated in response to your use of the VERIFY 
option is copying files from a tape volume that was originally written without the 
VERIFY option selected. The process continues without checksum comparison 
tests of the input files. 


@ No action is required. 
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WARNING: TAPEMANAGER LIBRARY IS MISSING ONE OR MORE 
OBJECTS (MSRMISC209) 


e ASEND TM START MCP command has been entered. However, the MCP has 
determined that one or more of the standard TAPEMANAGER procedures has not 
been exported from the TAPEMANAGER library. 


If the CONTROL_INTERFACE procedure is missing, startup of the 
TAPEMANAGER library is stopped. In this case, the MCP follows this message 
with the following messages: 


TAPEMANAGER IS MISSING CONTROL_INTERFACE PROCEDURE 
TAPEMANAGER LIBRARY WILL NOT BE USED 


Descriptions of the additional messages appear in their respective alphabetical 
positions among the other descriptions in this appendix. 


If CONTROL_INTERFACE is missing, the MCP makes no use of the 
TAPEMANAGER library. If CONTROL_INTERFACE is present but one or 
more other procedures are missing, the MCP uses only those procedures that are 
present. 


e Determine whether the proper code file was named in the SL (Support Library) 
system command that was used to install the TAPEMANAGER library. If 
necessary, reissue the SL command with the correct code file name and resubmit 
the SEND TM START request. Check with the developer of the TAPEMANAGER 
library to verify that the proper entry points have been exported. See Section 5, 
“TAPEMANAGER Library Implementation,” for more information on 
TAPEMANAGER libraries. 


WARNING 56: ’TAPE7’, ’TAPE9’, AND ’TAPEPE’ ARE BEING 
DEIMPLEMENTED ON MARK 4.1. USE ’TAPE’. <rew> 
(MSRWARNG5S6) 


e As ofthe Mark 4.1 release of the A series software, any reference to TAPE7, 
TAPES, or TAPEPE will produce a syntax error. 


e No immediate action is required, but before you use the Mark 4.1 release of the 
software, Unisys recommends that you modify your programs to ensure that 
they specify TAPE rather than TAPE7, TAPES, or TAPEPE, and that they use 
the DENSITY file attribute to specify the density of a tape when a tape ci 
specification is required. 
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WARNING 57: SPECIFYING TAPE DENSITY WILL LIMIT OUTPUT | 
UNIT SELECTION TO QUALIFYING DEVICES ON MARK 4.1. 
<rew> (MSRWARNG5S57) 


e As of the Mark 4.1 release of the A series software, the system will reject any 
attempt to select nonqualifying devices if the tape density is specified. 


@ No immediate action is required, but before you use the Mark 4.1 release of the 
software, Unisys recommends that you modify your programs to ensure that when 
a tape density is specified, an appropriate unit is available. 


WARNING 58: ON MARK 4.1, INTERROGATING KIND FOR A TAPE 
DEVICE WILL ALWAYS RETURN ’TAPE’. <rcw> (MSRWARNGS58) 


e Asof the Mark 4.1 release of the A series software, the system will respond to any 
interrogation of the KIND value of a tape device with TAPE. 


@ No action is required. 


WARNING 59: ON MARK 4.1, THE RESOURCE’ TASK 
ATTRIB. WILL GOVERN TOTAL TAPE COUNT ONLY. <rew> 
(MSRWARNGS9) 


e As of the Mark 4.1 release of the A series software, the system will reject any 
attempt to use the RESOURCE task attribute for any purpose other than to govern 
the total tape count. 


@ No immediate action is required, but before you use the Mark 4.1 release of the 
software, Unisys recommends that you modify your programs to ensure that they 
do not attempt to use the RESOURCE task attribute for any purpose other than to 
govern the total tape count. 
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Standard Tape Formats 


This appendix illustrates the standard tape formats used on A Series systems. 


Note: The information in this appendix is based on Appendix G of the 
A Series I/O Subsystem Programming Guide. 


The figures in this appendix use the following notations: 


Notation Meaning 

* Tape mark 

a | Double tape mark separated by an interrecord gap 
EOF End-of-file code 

EOV End-of-volume code 

HDR File header 

RFE Reserved for expansion 

RFS Reserved for standard 

VOL Volume header 


Unlabeled Tapes 


Figure B-1 illustrates the formats of an unlabeled single-file tape and an unlabeled 
multifile tape. 


SINGLE-FILE VOLUME 


DATA =e 


MULTIFILE VOLUME 


FILE 1 DATA FILE n DATA ae 


Figure B-1. Unlabeled Single-File-Volume and Unlabeled Multifile-Volume Formats 
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ANSI X3.27-1969 (ANSI69) Tapes 


Figures B—2 through B-8 illustrate the formats of the following types of ANSI 
X3.27-1969 (ANSI69) tape labels: 

Single-file, single-volume tape 

Multivolume-file and multifile-volume tape 

Multifile, multivolume tape 

Volume header 

File header 1 

File header 2 

User header and trailer labels 


Figure B-9 illustrates the format of an ANSI69 scratch tape. 


ANSI69 tape labels are written in EBCDIC code. 


SINGLE FILE, SINGLE VOLUME 


VOLUME 1 | 
~ y - 


Figure B-2. ANSI69 Single-File, Single-Volume Format 
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MULTIVOLUME FILE 


| ~ palm _— 
VOLUME 1 
| 4 EOV1 ited VOL1 Yi EOV1 


| VOL1 HDR1 HDR2 VOLUME n DATA 
VOLUME n 
| (le - td 


MULTIFILE VOLUME 


VOL1 HDR1 x FILE 1 DATA 


HDR1 jem | FILE n DATA 
a EOF1 EOF2 Bz 


Figure B-3. ANSI69 Multivolume-File and Multifile-Volume Formats 


VOLUME 
=>N-1 


2 


VOLUME 1 


B-3 
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MULTIFILE, MULTIVOLUME 


VOL1 HDR1 HDR2 i‘ FILE 1 DATA 


VOLUME ‘1 


FIRST PART OF FILE 2 DATA 


PART OF FILE 2 DATA 


| [= [= 
VOLUME 2 


| / EOV1 halal 


= - cal 
FILE 3 DATA EOF1 EOF2 


Figure B-4. ANSI69 Multifile, Multivolume Format 


REMAINDER OF FILE 2 DATA 
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VOLUME HEADER - NON-SCRATCH TAPE 


1 5 11 «12 29 31 32 


VOLUME 
"VOLT" SERIAL MULTIFILE IDENTIFER 
NUMBER 


ACCESSIBILITY NAME 
SPACE - LABELED SPACES - NONE 
"BACKUP' - BACKUP 


- USER 

~ BACKUP 

- LIBRARY 

LOAD CONTROL 
- SYSTEM 

- A SERIES 
LIBRARY 
FIXED-BLOCK 
LIBRARY 


Aan PWN Fe 
‘ 


N 
i] 


32 34 36 38 52 88 


MARK 
LEVEL 
NUMBER 


RFE 
(SPACES) 


OWNER 


: 1 
(NOT IMPLEMENTED) é 


TAPE LEVEL VALUE 


VOLUME HEADER - SCRATCH TAPE 


1 5 11 12 29 31 32 


VOLUME 
SERIAL 
NUMBER 


MULTIFILE 


4 
‘VOLI IDENTIFIER 


SCRATCHPOOL NAME TAPE TYPE 


OR 'X@' FOR 17 @ - SCRATCH 
ACCESSIBILITY 
@ - SCRATCH 
E - SCRATCH, 


DATA SECURITY ERASED 


32 55 56 82 


RFE RFE 
(SPACES) (SPACES) 


SCRATCHPOOL VALIDITY 
*P'-SCRATCHPOOL VALID 
SPACE-SCRATCHPOOL NOT VALID 


Figure B—-5. ANSI69 Volume Header Formats 
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B-6 


Notes: 


@ The MCP determines whether a tape is a scratch tape by 
examining characters 11 and 79 of the volume header: if 
character 11 is 0 or E and character 79 is 0, the MCP treats the 
tape as a scratch tape. 


@ The four characters of the mark digit and Mark level number 
fields combine to identify the Mark release level of the MCP that 
was active when the tape was created. For example, a tape 
created on a system running a 3.9 MCP stores the following 
values in characters 32 through 35 of its volume header: 


9369 


FILE HEADER 1 


1 5 22. C- 28 48 42 


FILE FILE . 
SECTION | SEQUENCE] CYCLE | VERSION 
NUMBER | NUMBER ‘ 


FILE 
IDENTIFIER 


SET 
IDENTIFIER 


*HDR1' 


FIRST SIX VOLUME FILE NUMBER 
CHARACTERS NUMBER RELATIVE TO 
OF MULTIFILE RELATIVE VOLUME SET 
IDENTIFIER TO FILE 
42 48 54 55 74 8B 


RF ES 
(SPACES) 


61 68 
par ve BLOCK RECORD SYSTEM 
(bYYDDD) (bYYpDD) COUNT COUNT | IDENTIFIER 


ACCESSIBILITY 
(NOT IMPLEMENTED) 
(SPACE) 


Figure B-6. ANSI69 File Header 1 Format 


@ IN HDR1 
MEANINGFUL VALUE 
IN EOF1 AND EOV1 


A first end-of-file label is the same as a first file header, except that the first four 
characters contain the letters EOF1 and the block and record counts contain 
meaningful information. 


An end-of-volume label is the same as the first end-of-file label, except that the first 
four characters contain the letters EOV1. 
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FILE HEADER 2 


1 5 6 ll 16 


MAXIMUM 
RECORD LENGTH 
(EXTMODE 
UNITS) 


BLOCK LENGTH 
(EXTMODE 
UNITS) 


RECORD FORMAT 
F - FIXED LENGTH 
(BLOCKSTRUCTURE=FIXED) 
VARIABLE LENGTH IN 
DECIMAL IN FIRST FOUR 
CHARACTERS 
(BLOCKSTRUCTURE=VARIABLE) 
V - VARIABLE LENGTH IN 
BINARY IN FIRST TWO 
CHARACTERS 
(BLOCKSTRUCTURE=VARIABLEZ) 
U - UNDEFINED 
(BLOCKSTRUCTURE=EXTERNAL) 
I - VARIABLE LENGTH IN RECORD 
AT FIXED LOCATION 
(BLOCKSTRUCTURE= 
VARIABLEOFFSET) 
L - LINKS 
(BLOCKSTRUCTURE=LINKED) 


D 


4B 41 


36 «37 


26 31 


OFFSET 
TO SIZE 
FIELD 


SIZE MODE 
@ - SINGLE 
2 - HEX 
4 - EBCDIC 
5 - ASCII 


19 28 21 26 


MINIMUM 
RECORD LENGTH 
(EXTMODE 
UNITS) 


17 «18 


PROTECTED 
@ - NOT PROTECTED 
1 - PROTECTED 


EXTMODE 


@ - SINGLE (WORDS) 
2 - HEX 

4 - EBCDIC 

5 - ASCII 


PARITY 
6 - ALPHA (EVEN) 
1 - BINARY (ODD) 


SENTINEL 
@ - FILE SECTION EQUAL TO 1 
1 - FILE SECTION NOT EQUAL TO 1 


DENSITY 
B - 826 4 - 6258 
1 - 556 5 - 38228 
2 - 226 6 - 1256 
3 - 1688 


4 


4 49 51533 8a 
RFE RFE 
(SPACES) (SPACES) 


OFFSET TO DATA 
@ ~ NOT PROTECTED 
6 - PROTECTED 


SYSTEM SERIAL ‘NUMBER 


TAPE UNIT NUMBER 


BLOCKING UNITS 
@ - WORDS 
1 - CHARACTERS 


SYSTEM SERIAL NUMBER 
(LAST THREE DIGITS) 


Figure B-7. ANSI69 File Header 2 Format 
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A second end-of-file label is the same as the second file header, except that the first four 
characters contain the letters EOF2. 


Figure B-8 illustrates the formats of user header and trailer labels on ANSI69 tapes. 


User header labels can appear immediately after the characters HDR2 and before the 
tape mark, and user trailer labels can appear after either EOF2 or EOV1. 


USERS' LABEL 


LABEL USERS‘ PORTION 
(1<n<9) 


UHL - USER HEADER LABEL 
UTL - USER TRAILER LABEL 


Figure B~8. ANSI69 User Header and Trailer Label Formats 


Figure B-9 illustrates the format of an ANSI69 scratch tape. 


ANSI69 SCRATCH TAPE FORMAT 


VOL1. 


Figure B-9. ANSI69 Scratch Tape Format 


ANSI X3.27-1987 (ANSI87) Tapes 


B-8 


Figures B—10 through B-16 illustrate the formats of the following types of ANSI87 
tape labels: 


Multivolume file 
Multifile volume 
Volume 1 header 
Volume 2 header 
Volume 3 header 
File 1 header 
File 2 header 
File 3 header 
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Figure B-17 illustrates the format of an ANSI87 scratch tape. 


ANSI87 tape labels are written in ASCII code. 


MULTIVOLUME FILE 


| | vol. | vor2 | HORI joe HDR3 B7 


VOLUME 1 


VOLUME n 


MULTIFILE VOLUME 


- _ bee - 
FILE 1 DATA E EOF1 
VOLUME 1 
HDR1 om HDR3 p 


Figure B-10. ANSI87 Multivolume-File and Multifile-Volume Formats 
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MULTIFILE, MULTIVOLUME 


VOL1 VOL2 HDR1 om HDR3 [ FILE 1 DATA 
_ EOV1 EOV2 EOV3 G 


VOL1 VOL2 HDR1 om HDR3 
EOVl | E0V2 EOV3 : 


ial a, 7 . 
A EOF1 EOF2 | €£0F3 HOR1 jem ~ -HDR3 “V/V 
FILE 3 DATA C EOF1 EOF2 EOF3 


Figure B~11. ANSI87 Multifile, Multivolume Format 


FIRST PART OF FILE 2 DATA 


PART OF FILE 2 DATA 


; 


VOLUME 2 


La 


; 


VOLUME 3 


REMAINDER OF FILE 2 DATA 
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VOLUME 1 HEADER 


1 5 11 12 25 38 
reed teers RES IMPLEMENTATION 
SEER (SPACES) IDENTIFIER 
ACCESSIBILITY 25:6 'MCP/AS' 
@ - SCRATCH 31:2 LABEL LEVEL=4 
E - SCRATCH, DATA 33:5 MARK LEVEL CYCLE OF MCP 


SECURITY ERASED 
SPACE - NON-SCRATCH 


89 


OWNER RFS 
IDENTIFIER (SPACES) 


NOT IMPLEMENTED 4 - ANSI87 
(SPACES) 


Figure B-12. ANSI87 Volume Header 1 Format 
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VOLUME 2 HEADER - NON-SCRATCH TAPE 
1 5 9 11 12 29 31 


SeUENEE REE MULTIFILE REE | TAPE 
NUMBER (SPACES) IDENTIFIER (SPACES) | TYPE 


- USER 

- BACKUP 

- LIBRARY 

LOAD CONTROL 

- SYSTEM 

- A SERIES 
LIBRARY 

~ FIXED-BLOCK 

LIBRARY 


WITHIN ' NAME 
VoLuME sET  SCRATCHPOOL VALIDITY = conces _ NONE 


(SPACE) "BACKUP' - BACKUP 


ANP WN re 
1 


™~ 


32 34 51 


FAMILY 
SECURITYGUARD | RF E 
et | LENGTH (SPACES) SECURITYTYPE | SECURITYUSE aus) 


hoe 


SPACES - NONE on ~ NONE = ~ NONE 
B - SPACES - NONE @ - PUBLIC @ - INPUT/OUTPUT 
1 - . - LENGTH OF 1 - GUARDED 1 - INPUT 
NAME. IN 2 - CONTROLLED 2 ~ OUTPUT 
FAMILY OWNER 3 - PRIVATE 3 ~ SECURED 
VOLUME 3 HEADER - NON-SCRATCH TAPE 
1 5 gg 


SECURITYGUARD 


VOLUME 2 HEADER - SCRATCH TAPE 


1 5 9 9 31 
staan REE MULTIFILE RFE 
ores (SPACES) IDENTIFIER (SPACES) 
SPACES SCRATCHPOOL VALIDITY SCRATCHPOOL NAME 
'P'SCRATCHPOOL VALID OR 'XO' FOR 17 
SPACE-SCRATCHPOOL NOT VALID 
31.32 | 8a 


RFE 
(SPACES) 


@ - SCRATCH 


Figure B-13. ANSI87 Volume Header 2 and Volume Header 3 Formats 
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Notes: 
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If the FAMILY OWNER LENGTH field (characters 32 and 33) 
of the volume 2 header contains spaces or a zero, the MCP 
ignores the FAMILY OWNER field (characters 34-50). 


A tape includes a volume 3 header label if a nonzero 

value appears in the SECURITYGUARD LENGTH field 
(characters 51-53) of the volume 2 header. A volume 3 header 
label can vary in length from a minimum of 80 characters 

to a variable maximum number of characters that depends 
on the length of the SECURITYGUARD field. The length 

of the SECURITYGUARD field varies to accommodate the 
number of characters in the guard file title specified with the 
SECURITYGUARD file attribute. 
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FILE HEADER 1 


1 5 22 28 32 36 4g 42 


FILE FILE 


"HDR1° SECTION |SEQUENCE] CYCLE VERSION 
IDENTIFIER{IDENTIFIER NUMBER | NUMBER 


FIRST SIX VOLUME FILE 
CHARACTERS NUMBER NUMBER 

OF MULTIFILE RELATIVE RELATIVE 
IDENTIFIER TO FILE TO VOLUME SET 


42 48 54 


CREATION EXPIRATION 
DATE DATE 


42:1 SPACE 48:1 SPACE 
43:35 JULIAN DATE 49:5 JULIAN DATE 
54 55 61 74 89 


RFE IMPLEMENTATION RFS 
(SPACE) IDENTIFIER (SPACES) 


@ IN HORI 61:6 'MCP/AS' 
MEANINGFUL VALUE 67:2 LABEL LEVEL=4 
IN EOF1 AND EOV1 69:5 MARK LEVEL CYCLE OF MCP 


Figure B-14. ANSI87 File Header 1 Format 


Notes: 


@ A first end-of-file label is the same as a first file header, except 
that the first four characters contain the letters EOF 1 and the 
block count contains meaningful information. 


@ A first end-of-volume label is the same as the first end-of-file 


label, except that the first four characters contain the letters 
EOVI. 
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FILE HEADER 2 
1 5 6 11 16 24. 25 
MAX IMUM 


RECORD LENGTH 
(BYTES) 


RFE FRAMESIZE 
(SPACES) CODE 


RECORD } BLOCK LENGTH 
FORMAT (BYTES) 


F - FIXED LENGTH B- 4 
(BLOCKSTRUCTURE=FIXED) A jw 
D - VARIABLE LENGTH as: 
INTMODE=ASCII and 
UNITS=CHARACTERS 
(BLOCKSTRUCTURE=VARIABLE) 
S - NOT IMPLEMENTED 
1 - VARIABLE LENGTH 
INTMODE=NOT ASCII or 
UNITS=WORDS | 
(BLOCKSTRUCTURE=VARIABLE) 
V - VARIABLE LENGTH 
(BLOCKSTRUCTURE=VARIABLE2) 
U - UNDEFINED 
(BLOCKSTRUCTURE=EXTERNAL) 
I - VARIABLE LENGTH 
(BLOCKSTRUCTURE=VARIABLEOFFSET) 
Z - VARIABLE LENGTH 
(BLOCKSTRUCTURE=LINKED) 


25 26 36 37 4B 


RFE 


PROTECTED | SIZEOFFSET SIZE2 SIZEMODE (SPACES) 


@ - NOT PROTECTED 
1 - PROTECTED 


MEANINGFUL ONLY IF 
RECORD FORMAT = I 
(BLOCKSTRUCTURE = 
VARIABLEOFFSET) 


46 4 51 53 88 


1 5B 
BLOCKING | RECORD] RFE OFFSET RFE 
UNITS COUNT | (SPACE) (ZEROS) (SPACES) 


NOT IMPLEMENTED . 


@ IN HDR2 
MEANINGFUL VALUE 
IN EOF2 AND EOV2 
® ~- WORDS 

_1 - CHARACTERS 


Figure B-15. ANSI87 File Header 2 Format 
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Notes: 


@ A second end-of-file label is the same as a second file header, 
except that the first four characters contain the letters EOF2 and 
the record count contains meaningful information. 


@ A second end-of-volume label is the same as the second 


end-of-file label, except that the first four characters contain the 
letters EOV2. 


FILE HEADER 3 


1 5 1B 15 38 


BLOCK LENGTH MINIMUM MAXIMUM 
(EXTMODE RECORD LENGTH RECORD LENGTH 
UNITS) (EXTMODE UNITS) | (EXTMODE UNITS) 


RFE 


' t 
Hunt 5) ERTMODE (SPACES) 


SINGLE (WORDS) 
HEX 

EBCDIC 

ASCII 


nPM 


3g 47 a) 64 BB 


SYSTEM TAPE 
SERIAL UNIT 
NUMBER NUMBER 


MACHINE 
TYPE 


RFE 
(SPACES) 


Figure B~16. ANSI87 File Header 3 Format 


Note: 


e@ A third end-of-file label is the same as a third file header, except 
that the first four characters contain the letters EOFS. 


e A third end-of-volume label is the same as the third end-of-file 
label, except that the first four characters contain the letters 
EOVS. 


Figure B-17 illustrates the format of an ANSI87 scratch tape. 
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ANSI87 SCRATCH TAPE FORMAT 
VOLI VOL2 


Figure B-17. ANSI87 Scratch Tape Format 


B 3500 USASI Tapes 


Figures B-18 and B-19 illustrate the volume header format and the file header 1 
format for B 3500 USASI tape labels. 


VOLUME HEADER 
5 


VOLUME 
SERIAL SPACES 
NUMBER 


Figure B~18. B 3500 Volume Header Format 
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FILE HEADER 1 


1 5 


28 32 


SET IDENTIFIER 
"HDR1' | SPACES | FILE IDENTIFIER (MULTFILE 


IDENTIFIER) 


FILE SECTION 
NUMBER 
(VOLUME NUMBER) 


NAME OR 
"XO"FOR 17 
FOR SCRATCH TAPES 


32 36 4g 42 48 


GENERATION GENERATION CREATION 
NUMBER VERSION DATE 
(OPTIONAL) _ (OPTIONAL) (bYYDDD) 


FILE SEQUENCE 
NUMBER ('22@1') 


Snare BLOCK COUNT | RECORD CODE "BURbbb' 


' : SPACES 
(bYYDDD) B2O0BB (OPTIONAL) (OPTIONAL) 


ACCESSIBILITY 
(SPACES) 


Figure B-19. B 3500 File Header 1 Format 
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B 5500 Tapes 


Table B—1 describes the BCL characters that are common to all B 5500 tape labels. 


Table B~1. BCL Characters for B 5500 Tape Labels 


Character Character 
(Word) (Record) Field (Description) 


Must contain the word LABEL in uppercase 
letters 


Must be 0 

Multifile 1D 

Must be 0 

File ID 

Volume number (within file) 


Date written (creation date) 


Cycle number (to distinguish among 
identical runs on the same day) 


Purge date (date this file can be destroyed) 
Sentinel 

i = end-of-volume 

0 = end-of-file 

Block count 

Record count 


Memory dump key. If value is 1, the 
memory dump follows the label. 


Physical tape number 
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ALGOL Files 


Table B-2 describes the remaining information that is contained in a B 5500 tape label 
when the file is an ALGOL file. 


Table B-2. B 5500 Tape Label for ALGOL Files . 


Character Character 
Word (Word) (Record) Field (Description) 


Blocking indicator 

3 = blocked 

0 = not blocked 

Buffer size (number of words) 

Maximum record size (number of words) 


Zeros 


COBOL Files 


Table B-3 describes the remaining information that can be contained in a B 5500 tape 
label for a COBOL file. 


Table B-3. B 5500 Tape Label for COBOL Files 


Character Character 
(Word) (Record) Field (Description) © 


3-8 Reserved for file-control routine. Not 
currently used. 


1-end Users’ portion. Can be of any format desired 
by user and can be up to 8120 characters 
in length for tape files, up to 16 characters 
in length for card files, and up to 56 
characters in length for printer files. 
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Appendix C 
Understanding Railroad Diagrams 


What Are Railroad Diagrams? 


Railroad diagrams are diagrams that show you the rules for putting words and symbols 
together into commands and statements that the computer can understand. These 
diagrams consist of a series of paths that show the allowable structure, constants, and 
variables for a command or a statement. Paths show the order in which the command 
or statement is constructed. Paths are represented by horizontal and vertical lines. 
Many railroad diagrams have a number of different paths you can take to get to the 
end of the diagram. For example: 


— REMOVE 
SOURCE 
OBJECT 


If you follow this railroad diagram from left to right, you will discover three acceptable 
commands. These commands are 

@ REMOVE 

@ REMOVE SOURCE 

@ REMOVE OBJECT 

If all railroad diagrams were this simple, this explanation could end here. However, 


because the allowed ways of communicating with the computer can be complex, 
railroad diagrams sometimes must also be complex. 


Regardless of the level of complexity, all railroad diagrams are visual representations of 
commands and statements. Railroad diagrams are intended to 

Show the mandatory items. 

Show the user-selected items. 

Present the order in which the items must appear. 


Show the number of times an item can be repeated. 


Show the necessary punctuation. 


To familiarize you with railroad diagrams, this explanation describes the elements of 
the diagrams and provides examples. 


Some of the actual railroad diagrams you will encounter might be more complex. 
However, all railroad diagrams, simple or complex, follow the same basic rules. They 
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all consist of paths that represent the allowable structure, constants, and variables for 
commands and statements. 


By following railroad diagrams, you can easily understand the correct syntax for 
commands and statements. Once you become proficient in the use of railroad notation, 
the diagrams serve as quick references to the commands and statements. 


Constants and Variables" 


A constant is an item that cannot be altered. You must enter the constant as it appears 
in the diagram, either in full or as an allowable abbreviation. If a constant is partially 
underlined, you can abbreviate the constant by entering only the underlined letters. In 
addition to the underlined letters, any of the remaining letters can be entered. If no 
part of the constant is underlined, the constant cannot be abbreviated. Constants can 
be recognized by the fact that they are never enclosed in angle brackets (< >) and are 
in uppercase letters. 


A variable is an item that represents data. You can replace the variable with data that 
meets the requirements of the particular command or statement. When replacinga _ 
variable with data, you must follow the rules defined for the particular command or 
statement. Variables appear in railroad diagrams enclosed in angle brackets. 


In the following example, BEGIN and END are constants while <statement list> is a 
variable. The constant BEGIN can be abbreviated since it is partially underlined. Valid 
abbreviations for BEGIN are BE, BEG, and BEGI. 


— BEGIN —<statement list>— END ——@————____—_______ 


Constraints 


C-2 


Constraints are used in a railroad diagram to control progression through the diagram. 
Constraints consist of symbols and unique railroad diagram line paths. They include 


Vertical bars 
Percent signs 

Right arrows 
Required items 
User-selected items 


Loops 


Bridges 
A description of each item follows. 


Vertical Bar 


The vertical bar symbol (|) represents the end of a railroad diagram and indicates the 
command or statement can be followed by another command or statement. 
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— SECONDWORD — ( —<arithmetic expression>— ) ——————__ 


Percent Sign 


The percent sign (%) represents the end of a railroad diagram and indicates the 
command or statement must be on a line by itself. 


— STOP , % 


Right Arrow 


_ The right arrow symbol (>) is used when the railroad diagram is too long to fit on one 
line and must continue on the next. A right arrow appears at the end of the first line, 
and another right arrow appears at the beginning of the next line. 


— SCALERIGHT — ( —<arithmetic expression>— , ———————_———_—_> 


»—<arithmetic expression>— ) ae 


Required Items 


A required item can be either a constant, a variable, or punctuation. A required item 
appears as a single entry, by itself or with other items, on a horizontal line. Required 
items can also exist on horizontal lines within alternate paths or nested (lower-level) 
diagrams. If the path you are following contains a required item, you must enter the 
item in the command or statement; the required item cannot be omitted. 


In the following example, the word EVENT is a required constant and <identifier> is 
a required variable: 


— EVENT —<i dent fi er2>———___—____1 


User-Selected Items 


User-selected items appear one below the other in a vertical list. You can choose any 
one of the items from the list. If the list also contains an empty path (solid line), none 
of the choices are required. A user-selected item can be either a constant, a variable, or 
punctuation. In the following railroad diagram, either the plus sign (+) or the minus 
sign (—) can be entered before the required variable <arithmetic expression>, or the 
symbols can be disregarded because the diagram also contains an empty path. 


re thmetic expression>——————_________—_| 
+ 
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Loop 


A loop represents an item or group of items that you can repeat. A loop can span all or 
part of a railroad diagram. It always consists of at least two horizontal lines, one below 
the other, connected on both sides by vertical lines. The top line is a right-to-left path 
that contains information about repeating the loop. 


Some loops include a return character. A return character is a character—often a 
comma (,) or semicolon (;)— required before each repetition of a loop. If there is no 
return character, the items must be separated by one or more blank spaces. 


ee ees 


Bridge 


Sometimes a loop also includes a bridge, which is used to show the maximum number 
of times the loop can be repeated. The bridge can precede the contents of the loop, or it 
can precede the return character (if any) on the upper line of the loop. 


The bridge determines the number of times you can cross that point in the diagram. 
The bridge is an integer enclosed in sloping lines (/\). Not all loops have bridges. Those 
that do not can be repeated any number of times until all valid entries have been used. 
In the first bridge example, you can enter LINKAGE or RUNTIME no more than two 


times. In the second bridge example, you can enter LINKAGE or RUNTIME no more 
than three times. 


ee 
“ales RUNTIME 


—/2\ 
NW a a | 
RUNTIME 
In some bridges an asterisk (*) follows the number. The asterisk means that you must 


cross that point in the diagram at least once. The maximum number of times that you 
can cross that point is indicated by the number in the bridge. 


jen LINKAGE — . 
RUNTIME 


In the previous bridge example, you must enter LINKAGE at least once but no more 
than twice, and you can enter RUNTIME any number of times. 


The following figure shows the types of constraints used in railroad diagrams. 
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Vertical bar. Indicates that the 
command or statement can be followed 
by another command or statement. 


Percent sign. Indicates that the 
command or statement must be on a 
line by itself. 


> 
YES 
NO 


< 
Lin 


ies TG 
SSS 


Right arrow. Indicates that the 
diagram occupies more than one 
line. 


Required items. Indicates the 
constants, variables, and 
punctuation that must be entered 
in a command or statement. 


User-selected items. Indicates the 
items that appear one below the 
other in a vertical list. You 
select which item or items to include. 


i 


A loop. Indicates an item or group 
of items that can be repeated. 


A bridge. Indicates the maximum ° 
number of times a loop can be 
repeated. 


i 


Figure C-1. Railroad Constraints 


Following the Paths of a Railroad Diagram 


The paths of a railroad diagram lead you through the command or statement from 
beginning to end. Some railroad diagrams have only one path, while others have 


SYMBOL/PATH EXPLANATION - 


several alternate paths. The following railroad diagram indicates there is only one path 


that requires the constant LINKAGE and the variable <linkage mnemonic>: 
— LINKAGE —<linkage mnemoni ¢c>—————______________—_-_ 


Alternate paths provide choices in the construction of commands and statements. 


Alternate paths are provided by loops, user-selected items, or a combination of both. 


More complex railroad diagrams can consist of many alternate paths, or nested 
(lower-level) diagrams, that show a further level of detail. 


For example, the following railroad diagram consists of a top path and two alternate 


paths. The top path includes an ampersand (&) and the constants (that are 
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user-selected items) in the vertical list. These constants are within a loop that can be 
repeated any number of times until all options have been selected. The first alternate 
path requires the ampersand and the required constant ADDRESS. The second 
alternate path requires the ampersand followed by the required constant ALTER and 
the required variable <new value>. 


Railroad Diagram Examples with Sample Input 


C-6 


The following examples show five railroad diagrams and possible command and 
statement constructions based on the paths of these diagrams. 


Example 1 


<lock statement> 


— LOCK — ( — <file identifier> — ) —————___________ 


Sample Input Explanation 


LOCK (FILE4) LOCK is a constant and cannot be altered. Because no part 
of the word is underlined, the entire word must be entered. 


The parentheses are required punctuation, and FILE4 is a 
sample file identifier. 


Example 2 


<open statement> 


—— OPEN <database name>———————_________—____| 
E INQUIRY : 


UPDATE 


Sample Input Explanation 


OPEN DATABASE] The constant OPEN is followed by the variable DATABASE1, 
which is a database name. 


The railroad diagram shows two user-selected items, 
INQUIRY and UPDATE. However, because there is an empty 
path (solid line), these entries are not required. 


continued 
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continued 
Sample Input Explanation 
OPEN INQUIRY DATABASE1 The constant OPEN is followed by the user-selected 
constant INQUIRY and the variable DATABASE1. 
OPEN UPDATE DATABASE] The constant OPEN is followed by the user-selected 
constant UPDATE and the variable DATABASE1. 
Example 3 


<generate statement> 


— GENERATE —<subset>— = NULL 
<subset 
Sample Input Explanation 
GENERATE Z = NULL The GENERATE constant is followed by the variable Z, an 


equal sign (=), and the user-selected constant NULL. 


GENERATE Z = X The GENERATE constant is followed by the variable Z, an 
equal sign, and the user-selected variable X. 


GENERATE Z = X AND B The GENERATE constant is followed by the variable Z, an 
equal sign, the user-selected variable X, the AND command 
(from the list of user-selected items in the nested path), and 
a third variable, B. 


GENERATE Z=X+8B The GENERATE constant is followed by the variable Z, an 
equal sign, the user-selected variable X, the plus sign (from 
the list of user-selected items in the nested path), and a 
third variable, B. 
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Example 4 


<entity reference declaration> 


— ENTITY REFERENCE sate ref ID>— (—<class ID>— ) 


Sample Input Explanation 


ENTITY REFERENCE ADVISOR1 (INSTRUCTOR) The required item ENTITY 
REFERENCE is followed by the 
variable ADVISOR1 and the variable 
INSTRUCTOR. The parentheses are 


required. 
ENTITY REFERENCE ADVISOR1 (INSTRUCTOR), Because the diagram contains a 
ADVISOR2 (ASST_INSTRUCTOR) loop, the pair of variables can be 


repeated any number of times. 


Example 5 
— PS — MODIFY ———————_——____-_____ 


> request number 
request number>— - —<request number 
ALL 


EXCEPTIONS 


<file attribute phrase 


<print modifier phrase 


Sample Input | Explanation 
PS MODIFY 11159 The constants PS and MODIFY are followed 
by the variable 11159, which is a request 
number. 
PS MODIFY 11159,11160,11163 Because the diagram contains a loop, the 


variable 11159 can be followed by a 
comma, the variable 11160, another 
comma, and the final variable 11163. 


PS MOD 11159-11161 DESTINATION = The constants PS and MODIFY are followed 

"LP?" by the user-selected variables 
11159-11161, which are request numbers, 
and the user-selected variable DESTINATION 
= “LP7”, which is a file attribute phrase. 
Note that the constant MODIFY has been 
abbreviated to its minimum allowable form. 


PS MOD ALL EXCEPTIONS The constants PS and MODIFY are followed 
by the user-selected constants ALL and 
EXCEPTIONS. 
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ALGOL 
Algorithmic language. A structured, high-level programming language that provides 
the basis for the stack architecture of the Unisys A Series systems. ALGOL was the 
first block-structured language developed in the 1960s and served as a basis for such 
languages as Pascal and Ada. It is still used extensively on A Series systems, primarily 
for systems programming. 


ANSI 
American National Standards Institute. A nongovernmental, nonprofit organization 
that is the central body for coordinating voluntary standards in the United States. 
ANSI also serves as the United States member of the International Standards 
Organization (ISO). 

APL 


A Programming Language. A procedure-oriented language that can produce very short _ 
but powerful programs. . 


automatic-unload mode 
A mode of tape drive operation in which the system, after releasing the drive from use 
or performing a reel switch from the drive, rewinds and then automatically unloads the 
tape. 


BCL . 
See Burroughs Common Language. 


Burroughs Common Language (BCL) 
An obsolete code using 6-bit character representation. 


BNA 
The network architecture used on A Series, B 1000, and V Series systems as well as 
CP9500 and CP 2000 communications processors to connect multiple, independent, 
compatible computer systems into a network for distributed processing and resource 
sharing. 

Boolean 


Pertaining to variables, data items, and attributes having a value of TRUE or FALSE. 
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C 


CANDE 
See Command and Edit. 


Command and Edit (CANDE) 
A time-sharing message control system (MCS) that enables a user to create and edit 
files, and to develop, test, and execute programs, interactively. 


COBOL 
Common Business-Oriented Language. A widely used, procedure-oriented language 
intended for use in solving problems in business data processing. The main 
characteristics of COBOL are the easy readability of programs and a considerable 
degree of machine independence. COBOL is the most widely used procedure-oriented 
language. 


COBOL74 
A version of the COBOL language that is compatible with the American National 
Standard X3.23-1974. 


control file 
(1) In Data Management System IT (DMSI)), a file containing data file coordination 
information, audit control information, and dynamic database parameter values. (2) In 
the Generalized Message Control System (GEMCOS), a file named CQUS, and known 
externally as DATACOM/QUEUE/CONTROL, that is created by the transaction 
control language (TCL) compiler and contains all tables and values for all parameters 
specified in the TCL. 


D 


DASDL 
See Data and Structure Definition Language. 


Data and Structure Definition Language (DASDL) 
In Data Management System II (DMSID), the language used to describe a database 
' logically and physically, and to specify criteria to ensure the integrity of data stored 
in the database. DASDL is the source language that is input to the DASDL compiler, 
which creates or updates the database description file from the input. 


Data Management System IT (DMSII) 
A specialized system software package used to describe a database and maintain the 
relationships among the data elements in the database. 


distributed systems service (DSS) 
One of a collection of services provided on n Unisys hosts to support communications 
across multihost networks. DSSs can be services such as file handling, station transfer, 
and mail transfer. 


DMSII 
See Data Management System II. 


Glossary—2 8600 0940-000 


Glossary 


dump 
(1) A copy of data in memory or a copy of a program on a tape. (2) A process that writes 
the contents of a specific area of memory to record the contents of a particular stage of 
processing. This process is used to determine the cause of a failure. (3) To copy a file or 
program on a tape. (4) In data or file management, a copy of a database on a tape. 
DSS 


See distributed systems service. 


E 


EBCDIC 
Extended Binary Coded Decimal Interchange Code. An 8-bit code representing 256 
graphic and control characters that are the native character set of most mainframe 


EMS 
See entry and medium systems. 


end of file (EOF) 
A code at the end of a data file that signals that the last record in the file has been 
processed. 


end of task (EOT) 
The termination of processing of a task. 


entry and medium systems (EMS) 
A designation referring to the Micro Aand Al feos A 10 systems. 


EOF 
See end of file. 


EOT 
See end of task. 


F 


file 
A named group of related records. 


file equation 
A mechanism for specifying the values of file attributes when a program is compiled or 
executed. A file equation implicitly assigns a value to the FILECARDS task attribute. 


File Transfer Protocol (FTP) 
A protocol used to copy disk files between hosts souneeeA ACTOSS a Transmission 
Control Protocol/Internet Protocol (TCP/IP) network. 


FTP 
See File Transfer Protocol. 
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G 


GCR 
See group-coded recording. 


group-coded recording (GCR) 
A scheme for recording data on a magnetic tape (MT). 


H 


HDU 
See host data unit. 

host data unit (HDU) 
The A 12 and A 15 system host interface to the I/O subsystem. An HDU is configured 
with up to three host-dependent ports Cine each of which supports two message 
level interface (MLI) cables. 

1/O 


Input/output. An operation in which the system reads data from or writes data to a file 
on a peripheral device such as a disk drive. 


LAN 
See local area network. 


local area network (LAN) 
A network that enables high-speed communications among various devices within a 
relatively small area. 


locked unit 
Indicates that the unit is offline either because of an error that occurred during label 
processing or because certain operator commands such as PGL and SNL were entered. 


M 


‘MARC 
See Menu-Assisted Resource Control. 


master control program (MCP) 
The central program of the A Series operating system. The term applies to any master 
control program that Unisys may release for A Series systems. 

MCP 


See master control program. 
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MCS 


See message control system. 


Menu-Assisted Resource Control (MARC) . 
A menu-driven interface to A Series systems that also enables direct entry of 
commands. ; 


message control system (MCS) 
A program that controls the flow of messages between terminals, application programs, 
and the operating system. MCS functions can include message routing, access control, 
audit and recovery, system management, and message formatting. 


O 


ODT 
See operator display terminal. 


operator display terminal (ODT) 
A terminal or other device that is connected to the system in such a way that it can 
communicate directly with the operating system. The ODT allows operations personnel 
to accomplish system operations functions through either of two operating modes: 
system command mode or data comm mode. 


Pascal 
A high-level programming language developed by Niklaus Wirth, based on the block 
structuring nature of ALGOL 60 and the data structuring innovations of C.A.R. Hoare. 
Pascal is a general-purpose language. 

purge 


For magnetic tapes, an operation that writes a special label that contains the serial 
number of the tape and sets a flag that says no valid records are on the tape. The tape 
is not erased. 


R 


reel switch 
During the processing of a multivolume file, the traversal from one volume to the next. 


reorganization . 
In Data Management System II (DMSII), the process of reordering or reformatting 
data sets, sets, or subsets. Reorganization can restore space in files, reorder data 
sets for more efficient retrieval, and reformat data set records when items are added, 
deleted, or changed. 


resource management module (RMM) 


A hardware module that interfaces with the I/O subsystem and schedules tasks on the 
E-mode processor (EMP) by way of a message protocol. 
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RMM 


See resource management module. 


RPG 
Report Program Generator. A high-level, commercially oriented programming language 
used most frequently to produce reports based on information derived from data files. 


S 


scratch tape 
A labeled magnetic tape (MT) whose label indicates that there are no files on the tape. 
Old data might remain on the tape, but this old data cannot be read unless the tape is 
read as an unlabeled tape. The old data present on a scratch tape is written over when 
new data is written to the tape. 


Semantic Information Manager (SIM) 
(1) The basis of the InfoExec™ environment. SIM is a database management system 
used to describe and maintain associations among data by means of subclass-superclass — 
relationships and linking attributes. (2) In the Data Transfer System (DTS), a Unisys 
software product (SIM kernel) that DTS uses to extract data from host files. 


SIM 
See Semantic Information Manager. 


SQLDB 
See Structured Query Language Database. 

Structured Query Language Database (SQLDB) 
The A Series implementation of the American National Standards Institute (ANSD 
Structured Query Language (SQL). SQLDB includes a data definition language (DDL) 
for describing a relational database, and a data manipulation language (DML) anda 
module language for querying a relational database. 


substandard form name 
A 1-byte binary count followed by the EBCDIC characters of the name. 


T 


tape file . ‘ 
A discrete collection of information on one or more tape volumes. 


tape management system (TMS) 
Any application that is designed to record or control the usage of ans on a system. 


InfoExec is a trademark of Unisys Corporation. 
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tape volume 
A physical reel of magnetic oe (MT) which can be labeled or unlabeled, and can 
contain one or more files, if it is not a scratch tape. A scratch tape volume or 
uninitialized new tape volume contains no accessible files. | 


TCP/IP | 
See Transmission Control Protocol/Internet Protocol. 
TMS 
See tape management system (TMS). 
Transmission Control Protocol/Internet Protocol (TCP/IP) 
(1) A family of protocols that were originally developed for use in a Department 
of Defense network, and which have been widely adopted as standard protocols for 


multivendor networks. The applications protocols typically supported by TCP/IP are 
File Transfer Protocol (FTP), Simple Mail Transfer Protocol (SMTP), and Telnet. 


(2) A Unisys A Series product that provides telecommunications capabilities between 
A Series, 1100 Series, U Series, and other computing systems. The A Series TCP/IP 
product is designed to interoperate with other TCP/IP systems in a multivendor 
network using industry and military standard protocols. The A Series TCP/IP product — 
provides file transfer, station transfer, and (with the Mail System) mail transfer. 


USASI 
United States of America Standards Institute. The former name of the American 
National Standards Institute (ANSI). 


volume “ 
The medium of a mass storage device such as a disk, disk pack, or tape reel. 


WFL 
See Work Flow Language (WF L). 


WFL command | 
A Work Flow Language (WFL) statement entered as a command. The statements ADD, 
‘CHANGE, COPY, REMOVE, RUN, SECURITY, and START can be entered directly in 
the Action field of a MARC screen; any other WFL statement must be preceded by the 
characters WFL to be accepted as a WFL command. 


Work Flow Language (WFL) 
A Unisys language used for constructing jobs that compile or run programs on A Series 
systems. WIL includes variables, expressions, and flow-of-control statements that offer 
the programmer a wide range of capabilities with regard to task control. 
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Minor Type 5 (Tape Volume NEWFILE), 
1-12 
SETSTATUS call (LOGSETSTAT), 1-11 
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Tape Library Entry (Minor Type 26), 
1-12, 3-74 
Tape Volume Hold (Minor Type 18), 1-11, 
3-70, 3-71, 3-72, 3-73, 3-74 
Tape Volume New File (Minor Type 5), 
1-12 
Tape Volume Purged (Minor Type 3), 1-12 
Tape Volume Used File (Minor Type 12), 
1-11, 3-70, 3-71, 3-72, 3-78, 3-74 
Volume Status (LOGMAJVOL), 1-11 
log, system (SUMLOG), 1-11 
LOGCLOSETYPE (File Close) system log 
entry, 1-11 
logging new and changed log entries, 3-53 
CLU hardware report entries, aa 
file close entries, 3-60 
file open entries, 3-56 
SETSTATUS call entries, 3-68 
tape library entries, 3-74 
volume status entries, 3--70 
LOGIOERRORSNEW system option, 2-29 
LOGMAJLIBS (Tape Library Entry) system 
log entry, 3-74 
LOGMAJ MEDIALIB (Tape Library Entry) 
system log entry, 1-12 
LOGMAJVOL (Volume Status) system log 
entry, 1-11 
LOGOPENTYPE (File Open) system log 
entry, 1-11 
LOGPOSITIONING system option, 2-27 
LOGSETSTAT (SETSTATUS call) system 
log entry, 1-11 
LP (Lock Program) system command 
TAPEMANAGER library and, 5-57 
LPBDONLY system option, 2-23 
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MAINTENANCE status, unit, 2-12 
mark digit, B-6 
Mark level, B-6 
Mark release level, MCP 
active when tape was created, B-6 
master control program (MCP) 
exported procedures 
CALL_TAPEMANAGER, 5-53 
how it identifies scratch tapes, B-6 
mark digit, B-6 
Mark level, B-6 
options, 2-21 
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MAXINPUTS option, SEND (Send Message) 
system command, 2-47 
MCPINIT library attribute 
TAPEMANAGER libraries and, 5-10 
MCPTEST system option, 2-30 
media libraries, system commands, 2~53 
media type, defining scratch pools by, 1-2 
memory disk, 2-40 
displaying information, 2-40 
memory dump 
fatal, 2-23 
inhibiting, 2-23 
suppressing, 2-24 
messages, system 
ARCHIVE BACKUP ENTRY DELETED, 
A-3 
ASSIGNMENT STOPPED BY 
TAPEMANAGER LIBRARY, 5-29, 
A-4 
ATTERRI177, 5-36 
BAD DISK HEADER ON TAPE, A-4 
CANNOT QUIT TAPEMANAGER, A-5 
CANNOT START TAPEMANAGER, A-5 
DESTROYED VOLUME NOT ADDED 
IN SCRATCH POOL, A-5 
DISK FILE HEADER VERSION ERROR, 
A-6 
DUPLICATE SERIAL NUMBER, A-33 
END-OF-FILE READING HDRI LABEL, 
A-6 
ERROR CLOSING TAPE FILE, A-6 
ERROR OPENING TAPE FILE, A-6 
ERROR READING TAPE LABEL, A-7 
ERROR WRITING TAPE LABEL OR 
TAPE MARK, A-7 
ERROR: ATTRIBUTE MODIFICATION 
PROHIBITED, 5-36 
EXPECTED RECORD ID, A-7 
FAMILYOWNER MISMATCH.OR 
SECURITY ERROR, A-7 
FAULT REASON =, A-8 
FILE NOT VERIFIED, A-9 
FILE TITLE ERROR, A-10 
FILE VERIFIED, A-10 
<file name> REQUIRES 
<unit identifier>, 2-35, A-17 
example of, 1-4 
HISTORY REASON =, CAUSE =, 
TYPE=, A-10 
1/0 ERROR ON CHECKSUM RECORD, 
A-12 
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I/O ERROR READING HDR1 LABEL, MSRLM31, A-6 
A-12 MSRLM834, A-23 
T/O ERROR WHILE ACCESSING MSRLM8387, A-6 
GUARDFILE, A-13 . MSRLM39, A-7 
ILLEGAL OPTIONAL FILE, 5-29 MSRLM4, A-12 
INVALID DENSITY SPECIFIED, A~11 MSRLM42, A-13, A-31 
INVALID LIBRARY/MAINT TAPE MSRLM43, A-14, A-30 
BLOCKSIZE, A-11 MSRLM5, A-15 
IO ERROR DURING COMPARE, A-12 MSRLM6, A-23 
IO ERROR DURING COPY, A-12 MSRLM69, A-14 
LIBRARY CANNOT OPEN THIS FILE, MSRLM7, A-16 
5-25, 5-33, 5-34, A-13 MSRLM79, A-32 


MSRCAT11, A-30 
MSRCAT16, A-14 
MSRCAT26, A-19 
MSRCAT27, A-19 
MSRCATS, A-20 


MSRLM30, A-12 
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MSRLM8, A~7 

MSRLM81, A-24 
MSRLM82, A-35 
MSRLM84, A-12 
MSRLM85, A-20 


MSRDIRI, A~21 MSRLM8&6, A-10 

MSRDPC177, 5-31, A-15 MSRLM88, A-9 

MSRDPC18I1, 5-31, A-19 MSRLM90, A-20 

MSRDPC183, 5-31, A-18 MSRLM92, A-3 

MSRDPC93, A-17 MSRLM96, A-11 

MSRDPC96, A~11 MSRMISC117, 2-24 

MSREHO (TAPE READ), A-24 MSRMISC201, A-13 

MSREHO (TAPE WRITE), A-25 MSRMISC204, 5-13, A~30 
MSRFIB16, 5-29 MSRMISC205, A-29 

MSRFIB268, 5-33, A-17 MSRMISC206, A-26 

MSRFIB270, 5-25, 5-33, 5-34, A-13 MSRMISC207, A-26 
MSRFIB271, 5-29, A-4 MSRMISC208, 5-13, A-27, A~36 
MSRFIB74, A-15 MSRMISC209, 5-13, A-~27, A-28, A-36 
MSRFOUT11, A-13 MSRMISC210, 5-13, A-27, A-28, A-36 
MSRFOUT15, A-14 . MSRMISC211, A-26 
MSRFOUT23, 5-19, A-29 ~ MSRMISC212, A-5. 
MSRFOUTS30, 2-35, A-17 MSRMISC213, A-5 

MSRFOUTS0O, example of, 1-4 MSRMISC214, 5-38, A-25 
MSRFOUTSY, A-7 MSRMISC215, 5-38, A-26 
-MSRLMO, A-21, A-22 MSRMISC220, 5-59, A~28 
MSRLM1, A-22 MSRMISC221, 5-9, 5-59, A-8, A-10, A-31 
MSRLM11, A-10 MSRMISC222, 5-14, A~27 
MSRLM12, A-4 MSRMISC223, A-8 

MSRLM15, A-12 -MSRMISC224, A-10 

MSRLM17, A-21 MSRRS26, A-18 
-MSRLM19, A-5 MSRSOFT42, A-18 

MSRLM2, A~22, A-23 MSRVL12, A-35 

MSRLM21, A-7 MSRVLI16, A-15 

MSRLM22, A-30 MSRVS1, A~34 

MSRLM24, A-28 MSRVS10, A-33 

MSRLM26, A-6 MSRVS11, A-33 

MSRLM27, A-4 MSRVS12, A-33 

MSRLM29, A-6 MSRVS13, A-33 

MSRLM8, A-23 MSRVS14, A-34 


MSRVS15, A-33 
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MSRVS16, A-35 

MSRVS17, A-33 

MSRVS18, A-33 

MSRVS19, A-33 

MSRVS2, A-34 

MSRVS20, A-33 

MSRVS21, A-33 

MSRVS22, A-33 

MSRVS28, A-33, A-35 

MSRVS3, A-34 

MSRVS4, A-34 

MSRVS5, A-34 

MSRVS6, A-33 

MSRVS7, A-33 

MSRVS8, A-33 

MSRVS9, A-33 

MSRWARNG5S6, A-36 

MSRWARNG5S7, A-37 

MSRWARNGS58, A-37 

MSRWARNGSY, A-37 

NEED AN OUTPUT TAPE FOR OUMT, 
A-13 

NEW SOURCE UNIT OR VOLUME IS 
RESTRICTED, A-13, A-31 

NO CATALOG ACTION (LIBRARY 
TAPE), A-14 

NO ENTRY FOR VOLUME IN ’VOLUME 
DIRECTORY’, A-14 

NO RECOPY WHEN USING THIS KIND 
OF TAPE, A-14 

NOT A SCRATCH VOLUME, A-15 

NOT CLOSED, A-15 

PURGE REQUEST REJECTED BY 
TAPEMANAGER, 5-31, A-15 

RECOPY REQD, A-15 

RECORD SEQUENCE ERROR, A-16 

REOPEN STOPPED BY 
TAPEMANAGER, 5-33, A-17 

REQUIRES VOLUME DELETE, A-17 

RESTART ABORTED, A-18 

SCRATCHPOOL REJECTED BY 
TAPEMANAGER, 5-31, A-18 

SECURITYLABELS REQUIRE ANSI87 
LABELS, A-18 | 

SERIAL NUMBER REJECTED BY 
TAPEMANAGER, 5-31, A-19 

SERIALNO MATCHES BUT TAPE IS A 
LIBRARY MAINTENANCE TAPE, 
A-19 

SERIALNO MATCHES BUT TAPE IS 
NOT FIRST REEL, A-19 
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TAPE DISKHEADER READ ERROR, 
A-22, A-23 

TAPE DISKHEADER WRITE ERROR, 
A-23 

TAPE DOESN’T SEEM TO BACKSPACE, 
A-4 

TAPE FILE MISSING, A-23 

TAPE POSITIONING ERROR, A-23 

TAPE READ ERROR, A-24 

TAPE WILL BE PURGED, A-24 

TAPE WRITE ERROR, A-25 

TAPEMANAGER FAILED IN 
INITIALIZATION PROCEDURE, 
5-38, A-25 

TAPEMANAGER FAILED IN 
TERMINATION PROCEDURE, 
5-38, A-26 

TAPEMANAGER IS ACTIVE, A-26 

TAPEMANAGER IS INACTIVE, A-26 

TAPEMANAGER LIBRARY HAS 
LINKED, A-26 

TAPEMANAGER LIBRARY IS 
ALREADY ACTIVE, 5-14, A-27 

TAPEMANAGER LIBRARY IS MISSING 
CONTROL INTERFACE, 5-13, 
A-27 

TAPEMANAGER LIBRARY WILL NOT 
BE USED, 5-13, A-27, A-28 

TAPEMANAGER REQUIRED, 5-59, 
A-28 

TITLE FOUND WAS, A-28 

TYPE DISAGREES WITH KIND, 5-19, 
A-29 

UNABLE TO LINK TO 
TAPEMANAGER, 5-13, A~30 

UNABLE TO LINK TO TAPEMANAGER 
LIBRARY, A-29, A-30 

UNEXPECTED TAPE MARK, A-30 

UNIT NOT VOLUMED, A-30 

UNRESTRICT SOURCE AND REPLY 
OK TO COPY, A-14, A-30 

USER PROCESS FAULTED OR DSED 
IN TAPEMANAGER, 5-9, 5-59, 
A-8, A-10, A-31 

VERIFY ERROR, A-32 

VOLUME DIRECTORY, A-33 

VOLUME DIRECTORY <action> NOT 

- DONE, A-35 

VOLUME DIRECTORY FAULT IN 
VSHANDLER, A-34 

VOLUME DIRECTORY NOT SNED, 
A-35 
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VOLUME DIRECTORY RECORD HAS 
INVALID DATA, A-34 

VOLUME FAMILY NOT DELETED, 
A-35 

WARNING 56, A-36 

WARNING 57, A-37 

WARNING 58, A-37 

WARNING 59, A-37 

WARNING, TAPE WAS NOT WRITTEN 
WITH CHECKSUMS, A-35 

WARNING: TAPEMANAGER LIBRARY 


IS MISSING OBJECTS, 5-13, A-27, 


A-28, A-36 
"OP AUTORUNNING?’ IS SET, REPLY 
<reply> ASSUMED, 2-24 
Minor Type 12 (Tape Volume Used) system 
log entry, 1-11, 3-70, 3-71, 3-72, 
3-73, 3-74 
Minor Type 13 (Tape Volume Hold) system 
log entry, 1-11, 3-70, 3-71, 3-72, 
3-73, 3-74 
Minor Type 26 (Tape Library Entry) system 
log entry, 1-12, 3-74 
Minor Type 3 (Tape Volume Purged) system 
log entry, 1-12 
Minor Type 5 (Tape Volume NEWFILE) 
system log entry, 1-12 
mirrored sets 
bringing on line, 2-28 
MIRRORING system option, 2-28 
mix entries, waiting, 2-45 
MODE (Unit Mode) system command, 1-6, 
2-4 
MP (Mark Program) system command 
assigning identity to TAPEMANAGER 
library, 5—7, 5-56 
MSRCAT11 system message, A-30 
MSRCAT16 system message, A-14 
MSRCAT26 system message, A—19 
MSRCAT27 system message, A-19 
MSRCAT9 system message, A-20 
MSRDIR1 system message, A-21 
MSRDPC177 system message, 5-31, A-15 
MSRDPC181 system message, 5-31, A-19 
MSRDPC183 system message, 5-31, A-18 
MSRDPC93 system message, A-17 
MSRDPC96 system message, A~11 
MSREHO0 (TAPE READ) system message, 
A-24 
MSREHO (TAPE WRITE) system message, 
A-25 
MSRFIB16 system message, 5-29 
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MSRFIB268 system message, 5-33, A~17 
MSRFIB270 system message, 5-25, 5-33, 
5-34, A~13 
MSRFIB271 system message, 5-29, A-4 
MSRFIB74 system message, A-15 
MSRFOUTI1I1 system message, A-13 
MSRFOUTI5 system message, A~-14 
MSRFOUT28 system message, 5-19, A~29 
MSRFOUTS30 system message, 2-35, A~17 
MSRFOUTS0 system message, example of, 
1-4 
MSRFOUTS system message, A-7 
MSRLMO system message, A~21, A-22 
MSRLM1 system message, A-22 
MSRLM11 system message, A~10 
MSRLM12 system message, A-4 
MSRLM15 system message, A-12 
MSRLM17 system message, A-21 
MSRLM2 system message, A-22, A~23 
MSRLM21 system message, A-7 
MSRLM22 system message, A-30 
MSRLM24 system message, A-28 
MSRLM26 system message, A-6 
MSRLM27 system message, A-4 
MSRLM29 system message, A-6. 
MSRLMS8 system message, A-23 
MSRLM30 system message, A-12 
MSRLMS31 system message, A-6 
MSRLM34 system message, A-23 
MSRLM87 system message, A-6 
MSRLM39 system message, A-7 
MSRLM4 system message, A-12 
MSRLM42 system message, A-13, A~31 
MSRLM43 system message, A-14, A-30 
MSRLM5B system message, A-15 
MSRLM6 system message, A-23 
MSRLM69 system message, A-14 
MSRLM7 system message, A-16 
MSRLM79 system message, A-32 
MSRLMS8 system message, A-7 | 
MSRLM81 system message, A-24 
MSRLM82 system message, A-35 
MSRLM8&4 system message, A-12 
MSRLM85 system message, A-20 
MSRLM8&6 system message, A-10 
MSRLM88 system message, A-9 
MSRLM90 system message, A-20 
MSRLM92 system message, A-3 
MSRLM96 system message, A-11 
MSRMISC117 system message, 2~24 
MSRMISC201 system message, A~13 
MSRMISC204 system message, 5-13, A-30 
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MSRMISC205 system message, A-29 
MSRMISC206 system message, A-26 
MSRMISC207 system message, A-26 
MSRMISC208 system message, 5-13, A-27, 
A-36 
MSRMISC209 system message, 5-13, A-27, 
A-28, A-36 
MSRMISC210 system message, 5-13, A-27, 
A-28, A-36 
MSRMISC211 system message, A-26 
MSRMISC212 system message, A-5 — 
MSRMISC213 system message, A-5 
MSRMISC214 system message, 5-38, A-25 
MSRMISC215 system message, 5-38, A-26 
MSRMISC220 system message, 5-59, A-28 
MSRMISC221 system message, 5-9, 5-59, 
A-8, A-10, A-31 
MSRMISC222 system message, 5-14, A-27 
MSRMISC223 system message, A-8 
MSRMISC224 system message, A~10 
MSRRS26 system message, A-18 
MSRSOFT42 system message, A-18 
MSRVL12 system message, A-35 
MSRVLI16 system message, A~-15 
MSRVL19 system message, A-5 
MSRVS1 system message, A-34 
MSRVS10 system message, A-33 
MSRVS11 system message, A-33 
MSRVS12 system message, A-33 
MSRVS13 system message, A-33 
MSRVS14 system message, A~34 
MSRVS15 system message, A-33 
MSRVS16 system message, A—35 
MSRVS17 system message, A-33 
MSRVS18 system message, A-33 
MSRVS19 system message, A-33 
MSRVS2 system message, A-34 
MSRVS20 system message, A-33 
MSRVS21 system message, A-33 
MSRVS22 system message, A~33 
MSRVS23 system message, A-33, A-35 
MSRVSS3 system message, A~34. > 
MSRVS4 system message, A~34 
MSRVS5 system message, A-34 
MSRVS6 system message, A-33 
MSRVS7 system message, A-33 
MSRVS8 system message, A-33 
MSRVS9 system message, A-33 
MSRWARNGS6 system message, A-36 
MSRWARNG57 system message, A-37 
MSRWARNGS5S8 system message, A-37 
MSRWARNGSSY system message, A-37 
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MT status, 2-37 
multifile volumes 
ANSI69 tape format, B-2 
ANSI87 tape format, B-9 
unlabeled tape format, B-1 
multifile, multivolume tapes 
ANSI69 format, B-3 
ANSI87 format, B—10 
multivolume files 
ANSI69 tape format, B—2 
ANSI87 tape format, B-9 
multivolume tapes 
TAPEMANAGER library and, 5-17 


N 


NEED AN OUTPUT TAPE FOR OUMT 
system message, A-13 
NETRECOVERY system option, 2-29 
network processor 
communicating with, 2-47 
creating new controller stack for, 2-53 
diagnostic commands, 2-48 
maximizing throughput, 2-48 
nondiagnostic commands, 2-48 . 
support library, 2-48 
system commands, 2-48 
NEW SOURCE UNIT OR VOLUME IS 
RESTRICTED system message, 
A-13, A-31 
NEWFILE file attribute, 1-12 
NEWP 
procedures exported by TAPEMANAGER 
library written in, 5-7 
TAPEMANAGER library exported 
procedures 
EXCEPTION, 5-8 
NEW _FILENAME parameter 
of CHECK_TAPE REOPEN procedure, 
5-33 
NF (No File) system command 
simulated by CHECK _TAPE_ 
ASSIGNMENT result, 5-18, 
5-29 
NO CATALOG ACTION (LIBRARY TAPE) 
system message, A-14 
NO ENTRY FOR VOLUME ’IN VOLUME 
DIRECTORY’ system message, A-14 
NO RECOPY WHEN USING THIS KIND 
: OF TAPE system message, A-14 
NOCHECK system option, 2—23 
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NODUMP system option, 2~24 
NOFETCH system option, 2-26 
NOSUMMARY system option, 2-26 
NOT A SCRATCH VOLUME system 
message, A-15 
NOT CLOSED system message, A~15 
NOT READY status, unit, 2-12 
notations, tape label illustrations, B—1 
NB (See network processor) 


0 


OF (Optional File) system command 
simulated by CHECK TAPE _ 
ASSIGNMENT result, 5-18, 
5-29 
OFFLINE status, unit, 2-12 
OK (Reactivate) system command 
and TAPEMANAGER INITIALIZATION 
independent runner, 5-13 
OKTIMEANDDATE system option, 2-26 
OL (Display Label and Paths) system 
command, 2-8 . 
ONEONLY library attribute 
TAPEMANAGER libraries and, 5-10 
ONLINE status, unit, 2-12 
OP (Options) command, 2-21 
OP AUTORUNNING IS SET system 
message, 2-24 
open operations, for tape files 
handling by TAPEMANAGER, 5-15 
open requests, in CHECK_TAPE_ 
ASSIGNMENT figure, 
5-17 . 
OPEN system option, 2-22 
options 
Data Management System IIT (DMSII) 
SERIALNO, 1-5 
master control program (MCP), 2-21 
security 
TAPECHECK, 1-8 
SEND (Send Message) system command 
ANALYZE, 2-47 
AUTOLOAD, 2-47 
BLOCKING, 2-47 
BLOCKTIMEOUT, 2-47 
BUFFERSIZE, 2-47 
DIAGNOSTICS, 2-47 
DUMB 2-47 
FREEINPUTS, 2-47 
ID, 2-47 
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INITIALREADS, 2-47 
LOAD, 2-47 
MAXINPUTS, 2-47 
PROGRAMDUMP 2-47 
QUIT, 2-47 

- RELEASE, 2-47 
RESET, 2-47 
SET, 2-47 
TANKING, 2-47 

system, 2-59 
ARCHIVING, 2-27 
AUDIT, 2-28 
AUTODC, 2-24 

-AUTORECOVERY, 2-23 
AUTORM, 2-23 
AUTORUNNING, 2-24 
BACKUPBYJOBNR, 2-26 
CATALOGING, 2-26 
CATTEST, 2-30 
CDONLY, 2-23 
CONVENTION, 2-60 
CPBDONLY, 2-24 
CRUNCH, 2-25 
DIAGNOSTICDUMB 2-28 
DIAGNOSTICS, 2-23 
DIRDEBUG, 2-26 
DUPINTRINSICS, 2-24 
DUPSUPERVISOR, 2-23 
EOTSTATISTICS, 2-29 
FILESATURATION, 2-28 
IODIAGNOSTICS, 2~30 
IORANGECHECK, 2-27 
ISCDEBUG, 2-30 
KEYEDIOINI, 2-28 
LABELFORMAT, 1-9, 1-10, 2-60, 3-7, 
3-43 
LABELFORMAT = ANSI87DEFAULT, 
1-9 

LANGUAGE, 2-60 
LOCKTRACE, 2-27 
LOGIOERRORSNEW, 2-29 
LOGPOSITIONING, 2-27 
LPBDONLY, 2-23 
MCPTEST, 2-30 
MIRRORING, 2-28 
NETRECOVERY, 2-29 
NOCHECK, 2-23 
NODUMBP 2-24 
NOFETCH, 2-26 
NOSUMMARY, 2-26 
OKTIMEANDDATE, 2-26 
OPEN, 2-22, 2-60 
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PATHBALANCING, 2-29 
PDTODISK, 2-26 
PORTDEBUG, 2-30 
RESOURCECHECK, 2-26 
SEND (Send Message), 2~47 
SERIALNUMBER, 2-27 
TAPEEXPIRATION, 1-11, 2-60 
TAPEMANAGER, 2-60 
TAPESERVER, 2-60 
TERMINATE, 2-22 
TRANSWARNINGS, 2-24 
USECATDEFAULT, 2-30 
OU (Output Unit) system command, 2-33, 
5-35, A-13 | 
causing CHECK TAPE UNIT_ 
ASSIGNMENT call, 
5-34 
detecting as source of UNITNO 
assignment, 5-20 
example of, 1-3 
outboard information 
control, 2~9 
port, 2-9 
output files, directing to device, 2-33 
overriding request for scratch pool 
example of, 1-3 
overriding scratch pool assignments, 1-2 


P 


packs, 2-43, (See also disks) 
locking, 2-43 
purging, 2-43 
sectors required on, 2-35 
parameters 
calls to SETSTATUS intrinsic, 1-8 
path 
dynamic balancing, 2—29 
peripheral devices, 2—8 
PATHBALANCING system option, 2-29 
PDTODISK system option, 2-26 
PER (Peripheral Status) system command, 
2-2, 2-37 
peripheral units 
status, 2-37 
BLASTED, 2-37 
U, 2-87 
UNINITIALIZED, 2-37 
UNLABELED, 2-37 
PG (Purge) 
SETSTATUS call, 1-8, 3-35 
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system command, 1-3, 2-43, 5-22 
causing CHECK TAPE PURGE call, 
5-30 
PGL (Purge and Lock) 
SETSTATUS call, 1-8, 3-35 
system command, 2—43 
pools, scratch, (See scratch pools) 
port 
inboard and outboard information, 2-9 
PORTDEBUG system option, 2-30 
PRIMARY option, VISIBLE DBS utility, 4-7 
printer 
backup disk, 2-23 
output, assigning to backup disk, 2-23 
printing 
by job number, 2-26 
procedures 
CALL_TAPEMANAGER, 5-7, 5-53, 5-54 
CHECK TAPE ASSIGNMENT, 5-25, 
5-29 
CHECK TAPE PURGE, 5-30, 5-31 
CHECK TAPE REOPEN, 5-32, 5-33 — 
CHECK TAPE UNIT_ASSIGNMENT, 
5-34, 5-36 
CONTROL INTERFACE, 5-38 
PROGRAM INTERFACE, 5-39, 5-40 
PROGRAMDUMP option, SEND (Send 
Message) system command, 2-47 
programmatic file close operations, 1-5 
PROGRAM INTERFACE procedure, 5-39, 
5-40 
effects if missing, 5-39 
programs 
pointing to scratch pools, 1-2 
purge operations, for tape files 
handling by TAPEMANAGER, 5-21 
PURGE REQUEST REJECTED BY 
TAPEMANAGER system message, 
5-31, A-15 
purging 
tapes 
asynchronously, 1-8 
examples of, 1-3 
synchronously, 1-8 
tapes, packs, or host control (HC) units, 
2-43 


Q 


quarter-inch tapes, 1-5 
queue 
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resource limit, 2-26 
QUIT option, SEND (Send Message) system 
command, 2-47 


R 


railroad diagrams, explanation of, C-1 
READPARTNER specification 
host control (HC) unit, 2-4 
READY status, unit, 2-12 
RECOPY REQD system message, A-15 
RECORD SEQUENCE ERROR system 
message, A-16 
recording TAPEMANAGER library 
changes to file attributes, 1-11 
reel switches, 1-5 
during copy of hazardous files, A-31 
in CHECK_TAPE ASSIGNMENT figure, 
5-17 
reel-to-reel tapes, 1-10 
RELEASE option, SEND (Send Message) 
system command, 2-47 
reliability, degraded, 2-23 
removing HOLD restriction, 1-7 
reopen accepted, in CHECK _ 
TAPE REOPEN figure, 
5-21 
REOPEN STOPPED BY TAPEMANAGER 
system message 
CHECK TAPE. REOPEN procedures 
and, 5-33, A-17 
reopening a tape, in CHECK TAPE OPEN 
figure, 5-20 
REPORT LOG ENTRIES procedure 
role in tape management systems, 5—6 
used to monitor tape expirations, 5-23 
REQUEST parameter 
CONTROL INTERFACE procedure, 5-38 
REQUEST_AND_ RESPONSE parameter 
CALL_TAPEMANAGER procedure, 5-54 
CHECK_TAPE ASSIGNMENT 
procedure, 5-27 
CHECK TAPE PURGE procedure, 5-30 
PROGRAM _ INTERFACE procedure, 
5-40 
REQUIRES VOLUME DELETE system 
message, A~17 
RESERVED status, unit, 2-12 
RESET option, SEND (Send Message) 
system command, 2-47 
RESOURCECHECK system option, 2-26 
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resources 
limit for queue, 2-26 
RESTART ABORTED system message, A-18 
RESTRICT (Restrict Unit or Volume) 
system command, A-14, A-30 
restrictions, HOLD, removing, 1-7 
RETAINED FILE parameter 
CHECK _TAPE REOPEN procedure, 
5-32 
RETAINED _FILE_TASK parameter 
CHECK TAPE REOPEN procedure, 
5-33 
rewinding tapes, 1-1, 1-5 
RFE (reserved for expansion) notation, B-1 
RFS (reserved by standard) notation, B—1 
RSVP requests 
AUTORUNNING system option and, 
2-24 
DIAGNOSTICS system option and, 2-23 
FOUTS0O, 1-4 
inappropriate OU response, A-13 
issued to operator, 1-2 
issued to operator display terminal 
(ODT), 1-4 
MSRFOUT23, 5-19, A-29 
MSRFOUTS30, 2-35 
MSRLM438, A-14, A-30 
MSRMISC204, 5-13, A-30 
MSRMISC220, 5-59, A-28 
MSRMISC221, 5-9, 5-59, A-8, A~10, A-31 
NP support library and, 2-48 
OKTIMEANDDATE system option and, 
2-25 
OU (Output Unit) system command and, 
A-13 
PG (Purge) system command and, 2-48, 
2-45 
RY (Ready) system command, 2-2, 2-43, 
2-48, 2-57, A-13 


S 


sample program, TAPEMANAGER library, 
5-41 
SAVEFACTOR 
file attribute 
tape expiration and, 5-23 
volume attribute, 1-10 
scratch pools, 1-1, 1-2 
assigning tapes to, 1-3 
assigning tapes to, examples of, 1-3 
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assignments, overriding, 1-2 
creating as part of tape purges, 1-2. 
defining 
by account number, 1-2 
by media type, 1-2 
for archive tapes, 1-2 
for dump tapes, 1-2 
names, 1-2, 4-4, 4-6, 4-7 
overriding request for, example of, 1-3 
pointing to 
in DMSII utilities, 1-2 
in programs, 1-2 
in system commands, 1-2 
writing program output to, ALGOL 
example, 1-4 
scratch tapes, 1-1, 1-2, 1-10 
ANSI69 format, B~8 
ANSI87 format, B~17 
format | 
ANSI69, B-6 
ANSI87, B-17 
how MCP identifies, B-6 
logical groups of (scratch pools), 1-1 
SCRATCHPOOL file attribute, 1-3, 3-5, 
3-51 
changing 
VISIBLE DBS utility AUDIT 
SCRATCHPOOL command, 1-5, 4-6 
COPY command of COPYAUDIT utility, 
4-6 


COPY statement of Work Flow Language 


(WFL), 3-51 
dump media, 4-4 
Work Flow Language (WFL), 3-47 
SCRATCHPOOL REJECTED BY 
TAPEMANAGER system message, 
5-31, A-18 
SECONDARY option, VISIBLE DBS utility, 
4-7 
SECOPT (Security Options) system 
command, 1-8 
security 
attributes, 1-8, 3-42 
attributes, volume 
FAMILYOWNER, 3-53 
SECURITYGUARD, 3-53 
SECURITYTYPE, 3-53 
SECURITYUSE, 3-53 
enhancement software (InfoGuard), 1-1, 
1-8 
enhancements, 1-8, 3-42 
options 
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SECOPT (Security Options) system 
command, TAPECHECK, 1-8 
SECURITY statement 
TAPEMANAGER library, 5-56 
Work Flow Language (WF L), 5-56 
SECURITYGUARD 
volume attribute, 3-42 
volume security attribute, 3-53 
SECURITYLABELS REQUIRE ANSI87 
LABELS system message, A-18 
SECURITYLABELS volume attribute, 1-8, 
1-9, 3-8, 3-42, 3-43, 3-51, 3-53 
Work Flow Language (WFL), 1-8, 3-51 
SECURITYTYPE 
volume attribute, 3-42 
volume security attribute, 3-53 
SECURITYUSE 
volume attribute, 3-42 
volume security attribute, 3-53 
Semantic Information Manager (SIM) 
TAPEMANAGER library and, 5-8 
SEND (Send Message) system command, 
2-47 
and freeze type TAPEMANAGER library, 
—  &T 
and TAPEMANAGER security features, 
5~11 
and TERMINATING status of ; 
TAPEMANAGER, 5-56 _ 
causing CONTROL INTERFACE call, 
5-37 
displaying TAPEMANAGER status, 5-56 
effect of redundant START messages, — 
5-15 
effect on TAPEMANAGER library 
implementation, 5-7 
implementing TAPEMANAGER response 
to QUIT message, 5-14 
initiating TAPEMANAGER library, 5-56 
options 
ANALYZE, 2-47 
_ AUTOLOAD, 2-47 
BLOCKING, 2-47 
BLOCKTIMEOUT, 2-47 
BUFFERSIZE, 2-47 
DASNAME, 2-47 
DIAGNOSTICS, 2-47 
DUMB, 2-47 
FREEINPUTS, 2-47 
ID, 2-47 . 
INITIALREADS, 2-47 
LOAD, 2-47 


Index—17 


index 


MAXINPUTS, 2-47 
PROGRAMDUMB 2-47 
QUIT, 2-47 
RELEASE, 2-47 
RESET, 2-47 
SET, 2-47 
TANKING, 2-47 © 
processes suspended because of QUIT 
message, 5-59 
QUIT message used for updating 
TAPEMANAGER version, 5-60 
STATUS message responses generated by 
MCP 5-37 
terminating TAPEMANAGER library, 
5-57 
text passed to CONTROL_INTERFACE 
REQUEST parameter, 5-38 
SEND TAPEMANAGER, SETSTATUS call, 
3-31 
SEND TAPESERVER, SETSTATUS call, 
3-31 
SEND TM QUIT system command, 2-54, 
5-14, 5-57, 5-60 
SEND TM START system command, 2-54, 
5-13, 5-14, A-27 . 
SEND TM STATUS system command, 2-55 
' SERIAL NUMBER REJECTED BY 
TAPEMANAGER system message, 
5-31, A-19 
serial numbers, 1-1 
assigning to tapes, 2-56 
examples of assigning, changing, 1-3 
SERIALNO file attribute, 2-27 
SERIALNO MATCHES BUT TAPE IS LIB. 
MAINT. TAPE system message, 
A-19 
SERIALNO MATCHES BUT TAPE IS NOT 
FIRST REEL system message, A-19 
SERIALNO MATCHES BUT TAPE NOT IN 
VOL. LIB. system message, A-20 
SERIALNO MISMATCH system message, 
A-20 
SERIALNO option, Data Management 
System IT (DMSID), 1-5 
SERIALNUMBER system option, 2-27 
SET option, SEND (Send Message) system 
command, 2-47 
SETSTATUS 
calls 
HOLD (Hold Unit for Operator Use), 
3-33 . 
PG (Purge), 3-35 


Index-18 


PGL (Purge and Lock), 3-35 
SEND TAPEMANAGER, 3-31 
SEND TAPESERVER, 3-31 
SN (Serial Number), 3-39 
SNL (Serial Number Locked), 3-39 
intrinsic 
calls to, 1-8 
calls to, parameter bit, 1-8 
role in tape management systems, 5-6 
SETSTATUS call (LOGSETSTAT) system 
log entry, 1-11 
SIM, (See Semantic Information Manager 
(SIM)) 
single-file tapes, unlabeled format, B—1 
single-file, single-volume tapes, ANSI69 
format, B—2 
SL (Support Library) system command 
installing TAPEMANAGER library, 5-55 
SN (Serial Number) 
SETSTATUS call, 1-8, 3-39 
system command, 1-3, 2-56 
causing CHECK TAPE PURGE call, 
5-30 
SNL (Serial Number Locked) 
SETSTATUS call, 1-8, 3-39 
system command, 2-56 
SOURCE parameter 
CHECK TAPE ASSIGNMENT 
procedure, 5-26 
CHECK_TAPE PURGE procedure, 5-30 
CHECK TAPE UNIT_ASSIGNMENT 
procedure, 5—35 
CONTROL INTERFACE procedure, 5-37 
SOURCE TAPE MISSING system message, 
A-20 
SQLDB, (See Structured Query Language 
Database (SQLDB)) 
standard tape label formats, 1-9, 1-10, B-1 
standards 
ANSI X3.27-1969 (ANSI69), B-2 
. ANSI X3.27-1987 (ANSI87), 3-48, B-8 
statements, Work Flow Language (WFL) 
ADD, 1-3, 1-7 
ARCHIVE, 1-3 
COPY, 1-3, 1-5, 1-7 
VOLUME, 1-8, 3-42, 3-51 
statistics . 
end-of-task (EOT), 2-29 
status 
AUTOUNLOAD, 2-4 
control 
inboard and outboard, 2-9 
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units, 2-14 
disks, write-enable, 2-4 
HOLD of unit, 2-2, 2-33 
MT, 2-87 
paths, returned by OL system command, 
2-12 
peripheral units, 2-37 
BLASTED, 2-37 
U, 2-87 
UNINITIALIZED, 2-87 
UNLABELED, 2-37 
port, inboard and outboard, 2-9 
system, 2-45 
tape manager, 2-47, 2-55 
tape server, 2-47, 2-54 
TAPEMANAGER library, 5-56, 5-58 
ACTIVE, 5-14, 5-56 
GOINGAWAY, 5-15, 5-57, 5-58 
INACTIVE, 5-13, 5-56 
INITIALIZING, 5-14, 5-56 
LINKING, 5-13, 5-14, 5-56 
TERMINATING, 5-14, 5-56 
WAITING TO DELINK, 5-14, 5-57 
tapes, write-enable, 2-4 
units 
BLASTED, 2-37 
MAINTENANCE, 2-12 
NOT READY, 2-12 
OFFLINE, 2-12 
ONLINE, 2-12 
READY, 2-12 
RESERVED, 2-12 
returned by OL (Display Label and 
Paths) system command, 2—12 
U, 2-87 
UNINITIALIZED, 2-37 
UNLABELED, 2-37 
write-enable, 24 
volume, system log entries, 3-70 
waiting mix entries, 2-45 
status information retrieval 
role in TMS design, 5~4 
STATUS CHANGE REQUEST procedure 
role in tape management systems, 5-6 
Structured Query Language Database 
(SQLDB) 
TAPEMANAGER library and, 5-8 
supervisor program, 2—23 
support libraries 
customized TMSs as, 1-12 
network processor, 2-48 
TAPEMANAGER, 1-12 
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synchronous purges of tapes, 1-8 
SYSOPS (System Options) system command, 


1-9, 1-11, 2-59, 3-7, 3-43 
effect on CALL_TAPEMANAGER 
procedure, 5-53, 5-54 
installing TAPEMANAGER library, 5-55 
TAPEEXPIRATION option, 5-23 
temporarily suspending use of 
TAPEMANAGER library, 5-58 


system 


commands 
affected by scratch pools, 1-2 
DS (Discontinue), 5-57, 5-58 
FA (File Attributes), 5-26 
FR (Final Reel), 5-29 
FREE, 2-2 
HOLD (Hold Unit for Operator Use), 
1-7, 1-11, 1-12, 2-2, 2-3, 2-33 
HOLD (Hold Unit for Operator Use), 
examples of, 1—7 
IL (ignore Label), 5-34, 5-36 
media library, 2-53 
MODE (Unit Mode), 1-6, 2-4 
MODE (Unit Mode), examples of, 1-6 
network processor, 2-48 
OL (Display Label and Paths), 2-8 
OU (Output Unit), 1-3, 2-33, 5-34, 
5-35, A-13 . 
PER (Peripheral Status), 2-2, 2-37 
PG (Purge), 1-3, 2-43 
PGL (Purge and Lock), 2-43 
pointing to scratch pools, 1-2 
RESTRICT (Restrict Unit or Volume), 
A-14, A-30 
RY (Ready), 2-2, 2-48, 2-48, 2-57, 
A-13 
SECOPT (Security Options), 1~8 
SEND (Send Message), 2-47, 5-7, 5-57 
SEND TM QUIT, 2-54, 5-14, 5-57, 
5-60 
_ SEND TM START, 2-54, 5-13, 5-14, 
A-27 
SEND TM STATUS, 2-55 
SN (Serial Number), 1-3, 2-56 
SNL (Serial Number Locked), 2-56 
SYSOPS (System Options), 1-9, 1-11, 
2-59, 3-7, 3-43 
TDIR (Tape Directory), 2-3 
UL (Unlabeled), 5-34, 5-36 
initialization, 2-24 
intrinsics, 2-24 
log, 1-11 
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log entries 

CLU Hardware Report 
(CLUHWREPORT), 1-12 

CLUHWREPORT (CLU Hardware 
Report), 1-12 

File Close (LOGCLOSETYPE), 1-11 

File Open (LOGOPENTYPE), 1-11 

LOGCLOSETYPE (File Close), 1-11 

LOGMAJLIBS (Tape Library Entry), 
3-74 

LOGMAJ MEDIALIB (Tape Library 
Entry), 1-12 

LOGMAJVOL (Volume Status), 1-11 

LOGOPENTYPE (File Open), 1-11 

LOGSETSTAT (SETSTATUS call), 
1-11 

Minor Type 12 (Tape Volume Used), 
1-11, 3-70, 3-71, 3-72, 3-73, 3-74 

Minor Type 13 (Tape Volume Hold), 
1-11, 3-70, 3-71, 3-72, 3-73, 3-74 

Minor Type 26 (Tape Library Entry), 
1-12, 3-74 

Minor Type 3 (Tape Volume Purged), 
1-12 

Minor Type 5 (Tape Volume 
NEWFILE), 1-12 

SETSTATUS call (LOGSETSTAT), 
1-11 

Tape Library Entry (Minor Type 26), 
1-12, 3-74 

Tape Volume Hold (Minor Type 13), 
1-11, 3-70, 3-71, 3-72, 3-73, 3-74 


Tape Volume New File (Minor Type 5), 


1-12 

Tape Volume Purged (Minor Type 3), 
1-12 

Tape Volume Used File (Minor 
Type 12), 1-11, 3-70, 3-71, 3-72, 
3-73, 3-74 

Volume Status (LOGMAJVOL), 1-11 

messages 

ARCHIVE BACKUP ENTRY 

_ DELETED, A-3 

ASSIGNMENT STOPPED BY 
TAPEMANAGER LIBRARY, 5-29, 
A4 

ATTERR177, 5-36 

BAD DISK HEADER ON TAPE, A-4 

CANNOT QUIT TAPEMANAGER, 
A-5 

CANNOT START TAPEMANAGER, 
A-5 
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DESTROYED VOLUME NOT ADDED 
IN SCRATCH POOL, A-5 

DISK FILE HEADER VERSION 
ERROR, A-6 

DUPLICATE SERIAL NUMBER, A-33 


EEND-OF-FILE READING HDRI1 


LABEL, A-6 

ERROR CLOSING TAPE FILE, A-6 

ERROR OPENING TAPE FILE, A-6 

ERROR READING TAPE LABEL, A-7 

ERROR WRITING TAPE LABEL OR 
TAPE MARK, A~7 

ERROR: ATTRIBUTE 
MODIFICATION PROHIBITED, 
5-36 

EXPECTED RECORD ID, A-7 

FAMILYOWNER MISMATCH OR 
SECURITY ERROR, A-7 

FAULT REASON =, A-8 

FILE NOT VERIFIED, A-9 

FILE TITLE ERROR, A-10 

FILE VERIFIED, A-10 

<file name> REQUIRES 
<unit identifier>, 2-35, A-17 

<file name> REQUIRES ° 
<unit identifier>, example of, 1-4 

HISTORY REASON =, CAUSE =, 
TYPE =, A-10 

I/O ERROR ON CHECKSUM 
RECORD, A-12 

1/0 ERROR READING HDR1 LABEL, 
A-12 — 

I/O ERROR WHILE ACCESSING 
GUARDFILE, A-13 

ILLEGAL OPTIONAL FILE, 5-29 

INVALID DENSITY SPECIFIED, A-11 

INVALID LIBRARY/MAINT TAPE 
BLOCKSIZE, A-11 

IO ERROR DURING COMPARE, A-12 

IO ERROR DURING COPY, A-12 


LIBRARY CANNOT OPEN THIS 


FILE, 5-25, 5-33, 5-34, Bet 
MSRCAT11, A-30 


- MSRCAT16, A-14 


MSRCAT26, A-19 
MSRCAT27, A-19 
MSRCAT9, A-20 
MSRDIR1, A-21 
MSRDPC177, 5-31, A-15 
MSRDPC181, 5-31, A-19 
MSRDPC183, 5-31, A-18 
MSRDPC93, A-17 
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MSRDPC96, A-11 MSRMISC117, 2-24 

MSREHO (TAPE READ), A-24 MSRMISC201, A-13 

MSREHO (TAPE WRITE), A-25 MSRMISC204, 5-13, A-30 

MSRFIB16, 5-29 MSRMISC205, A-29 

MSRFIB268, 5-33, A-17 MSRMISC206, A-26 

MSRFIB270, 5-25, 5-33, 5-34, A-13 MSRMISC207, A-26 

MSRFIB271, 5-29, A-4 ° MSRMISC208, 5-13, A-27, A-36 
MSRFIB74, A-15 MSRMISC209, 5-13, A-27, A-28, A-36 
MSRFOUT11, A-13 MSRMISC210, 5-13, A-27, A=28, A-36 
MSRFOUTI5, A-14 MSRMISC211, A-26 
MSRFOUT23, 5-19, A-29 MSRMISC212, A-5 

MSRFOUTSO0, 2-35, A-17 MSRMISC213, A-5 

MSRFOUTS0, example of, 1-4 MSRMISC214, 5-38, A-25 
MSRFOUTS, A-7 MSRMISC215, 5-38, A-26 

MSRLMO, A-21, A-22 MSRMISC220, 5-59, A-28 


ee ee MSRMISC221, 5-9, 5-59, A-8, A-10, 
MSRLM11, A-10 ai 

ee MSRMISC222, 5-14, A-27 
soem year MSRMISC223, A-8 
Sere MSRMISC224, A-10 
ee MSRRS26, A-18 
MSRLM2, A-22, A-23 oor ie 
ene MSRVL12, A-35 
MSRLM22, A-30 ie oe 
MSRLM24, A-28 rT 
spc o MSRVS10, A-33 
MSRLM29. A-6 MSRVS11, A-33 
MSRLM3, A-23 MSRVS12, A-33 
MSRLM30, A-12 MSRVS13, A-33 
MSRLM31, A-6 MSRVS14, A-34 
MSRLM34, A-23 MSRVS15, A-33 
MSRLM37, A-6 MSRVS16, A-35 
MSRLMB9, A-7 MSRVS17, A-33 
MSRLM4A, A-12 MSRVS18, A-33 


MSRLM42, A-13, A-31 
MSRLM438, A-14, A-30 


MSRVS19, A-33 
MSRVS2, A-34 


MSRLM5, A-15 MSRVS820, A-33 
MSRLM6, A-23 MSRVS21, A-33 
MSRLM69, A-14 MSRVS22, A-33 
MSRLM7, A-16 MSRVS823, A-33, A-35 
MSRLM79, A-32 MSRVS8, A-34 
MSRLM8, A-7 MSRVS4, A-34 
MSRLM81, A-24 MSRVS5, A-34 
MSRLM82, A~35 MSRVS6, A-33 
MSRLM84, A-12 MSRVS7, A-33 
MSRLM85, A-20 MSRVS8, A-33 
MSRLM86, A-10 MSRVS9, A-33 
MSRLM88, A-9 MSRWARNGS56, A-36 
MSRLM90, A-20 MSRWARNG5S7, A-37 
MSRLM92, A-3 MSRWARNGS8, A-37 


MSRLM96, A-11 
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NEED AN OUTPUT TAPE FOR 
OUMT, A-13 

NEW SOURCE UNIT OR VOLUME IS 
RESTRICTED, A-13, A-31 

NO CATALOG ACTION (LIBRARY 
TAPE), A-14 

NO ENTRY FOR VOLUME IN 
*VOLUME DIRECTORY’, A-14 

NO RECOPY WHEN USING THIS 
KIND OF TAPE, A-14 

NOT A SCRATCH VOLUME, A-15 

NOT CLOSED, A-15 

PURGE REQUEST REJECTED BY 
TAPEMANAGER, 5-31, A-15 

RECOPY REQD, A~15 

RECORD SEQUENCE ERROR, A-16 

REOPEN STOPPED BY 
TAPEMANAGER, 5-33, A-17 

REQUIRES VOLUME DELETE, A-17 

RESTART ABORTED, A-18 

SCRATCHPOOL REJECTED BY 
TAPEMANAGER, 5-31, A-18 

SECURITYLABELS REQUIRE 
ANSI87 LABELS, A-18 

SERIAL NUMBER REJECTED BY 
TAPEMANAGER, 5-31, A-19 

SERIALNO MATCHES BUT TAPE 
IS A LIBRARY MAINTENANCE 
TAPE, A-19 

SERIALNO MATCHES BUT TAPE IS 
NOT FIRST REEL, A~19 

TAPE DISKHEADER READ ERROR, 
A-22, A~23 

TAPE DISKHEADER WRITE ERROR, 
A-23 

TAPE DOESN’T SEEM TO 
BACKSPACE, A-4 

TAPE FILE MISSING, A-23 

TAPE POSITIONING ERROR, A-23 

TAPE READ ERROR, A-24 

TAPE WILL BE PURGED, A~24 

TAPE WRITE ERROR, A-25 

TAPEMANAGER FAILED IN 
INITIALIZATION PROCEDURE, 
5-38, A-25 

TAPEMANAGER FAILED IN 
TERMINATION PROCEDURE, 
5-38, A-26 

TAPEMANAGER IS ACTIVE, A-26 

TAPEMANAGER IS INACTIVE, A-26 

TAPEMANAGER LIBRARY HAS 
LINKED, A-26 
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TAPEMANAGER LIBRARY IS 
ALREADY ACTIVE, 5-14, A-27 

TAPEMANAGER LIBRARY IS 
MISSING CONTROL INTERFACE, 
5-13, A-27 

TAPEMANAGER LIBRARY WILL 
NOT BE USED, 5-13, A-27, A-28 

TAPEMANAGER REQUIRED, 5-59, 
A-28 

TITLE FOUND WAS, A-28 

TYPE DISAGREES WITH KIND, 
5-19, A-29 

UNABLE TO LINK TO 
TAPEMANAGER, 5-13, A-30 

UNABLE TO LINK TO 
TAPEMANAGER LIBRARY, A-29, 
A-30 

UNEXPECTED TAPE MARK, A-30 

UNIT NOT VOLUMED, A-30 

UNRESTRICT SOURCE AND REPLY 
OK TO COPY, A-14, A-30 

USER PROCESS FAULTED OR DSED 
IN TAPEMANAGER, 5-9, 5-59, 
A-8, A-10, A-31 

VERIFY ERROR, A-32 

VOLUME DIRECTORY, A-33 

VOLUME DIRECTORY <action> 
NOT DONE, A-35 

VOLUME DIRECTORY FAULT IN 
VSHANDLER, A-34 

VOLUME DIRECTORY NOT SNED, 
A-35 

VOLUME DIRECTORY RECORD HAS 
INVALID DATA, A-34 

VOLUME FAMILY NOT DELETED, 
A-35 

WARNING 56, A-36 

WARNING 57, A-37 

WARNING 58, A-37 

WARNING 59, A-37 

WARNING, TAPE WAS NOT 
WRITTEN WITH CHECKSUMS, 
A-35 

WARNING: TAPEMANAGER 
LIBRARY IS MISSING OBJECTS, 
6-13, A-27, A-28, A-36 

"OP AUTORUNNING’ IS SET, REPLY 
<reply> ASSUMED, 2-24 


operations, automatic tape unloading and, 


1-6 


options, 2-21, 2-59 


ARCHIVING, 2-27 
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AUDIT, 2-28 

AUTODC, 2-24 

AUTORECOVERY, 2-23 

AUTORM, 2-23 

AUTORUNNING, 2-24 

BACKUPBYJOBNR, 2-26 

CATALOGING, 2-26 

CATTEST, 2-30 

CDONLY, 2-23 

CONVENTION, 2-60 

CPBDONLY, 2-24 

CRUNCH, 2-25 

DIAGNOSTICDUMB 2-28 

DIAGNOSTICS, 2-23 

DIRDEBUG, 2-26 

DUPINTRINSICS, 2-24 

DUPSUPERVISOR, 2-23 

EOTSTATISTICS, 2-29 

FILESATURATION, 2-28 

IODIAGNOSTICS, 2-30 

IORANGECHECK, 2-27 

ISCDEBUG, 2-30 

KEYEDIOII, 2—28 

LABELFORMAT, 1-9, 1-10, 2-60, 3-7, 
3-43 

LABELFORMAT = ANSI87DEFAULT, 
1-9 

LANGUAGE, 2-60 

LOCKTRACE, 2-27 

LOGIOERRORSNEW, 2-29 

LOGPOSITIONING, 2-27 

LPBDONLY, 2-23 

MCPTEST, 2-30 

MIRRORING, 2-28. 

NETRECOVERY, 2-29 

NOCHECK, 2-23 

NODUMP 2-24 

NOFETCH, 2-26 

NOSUMMARY, 2-26 

OKTIMEANDDATE, 2-26 

OPEN, 2~22, 2-60 

PATHBALANCING, 2-29 

PDTODISK, 2-26 

PORTDEBUG, 2-30 

RESOURCECHECK, 2-26 

SERIALNUMBER, 2-27 

TAPEEXPIRATION, 1-11, 2-60 

TAPEEXPIRATION, changing setting 
of, 1-11 

TAPEMANAGER, 2-60 

TAPESERVER, 2-60 

TERMINATE, 2-22 
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TRANSWARNINGS, 2-24 
USECATDEFAULYT, 2-30 
status, 2-45 
SYSTEMSTATUS function 
role in tape management systems, 5-6 


T 


table of contents, control file, 4~2 
TANKING option, SEND (Send Message) 
system command, 2-47 
tape 
assigning density, 2-56 
assigning serial number to, 2-56 
creation 
MCP Mark release active at, B—6 
density as criterion for purging, 2-44 
drives, automatic-unload mode, 1-6 
locking, 2-57 
purging, 2-56 
retrying errors, 2—27 
scratch, assigning, 2-27 . 
TAPE ABANDON FILEHANDLER system 
message, A-21 
tape assigned, in CHECK TAPE REOPEN 
figure, 5-21 
tape data, reading from expired tapes, 1-10 
TAPE DIRECTORY COMPARE ERROR 
system message, A-21 
TAPE DIRECTORY READ ERROR system 
message, A-21, A-22 
TAPE DIRECTORY WRITE ERROR system 
message, A—22 
TAPE DISKHEADER READ ERROR system 
message, A-22, A~23 
TAPE DISKHEADER WRITE ERROR 
| system message, A-23 
TAPE DOESN’T SEEM TO BACKSPACE 
system message, A-4 


_ tape drives, 1-1 


performing reel switches, default 
procedure, 1-5 
upon performing reel switches, 1-5 
when released from use, 1-5 
when released from use, default 
procedure, 1-5 | 
TAPE FILE MISSING system message, 
A-23 
tape labels 
examining before tapes assigned to tasks, 
1-7 
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formats 
ANSI69, 1-9, 1-10, 3-8, B-2 
ANSI87, 1-9, 1-10, 3-8, 3-43, B-8 
B 3500, B—17 
B 5500, B-19, B-20 
USASI B 3500, B-17 
specifying expiration date, 1-10 
Tape Library Entry (Minor Type 26) system 
log entry, 1-12, 3-74 
tape management 
operations, unattended, 1-5 
tape management system 
sample program, 5-41 
tape management system (TMS), 5-1 
creating, 1-12 
definition of, 1-12 
event and status information, 5-4 
tape manager status, 2-47, 2-55 
tape mark notation, tape label illustrations, 
B-1 
TAPE POSITIONING ERROR system 
message, A-23 
TAPE READ ERROR system message, A—24 
tape server status, 2-47, 2-54 
tape usage 
controlling with TMS, 1-13 
Tape Volume Hold (Minor Type 13) system 
log entry, 1-11, 3-70, 3-71, 3-72, 
3-73, 3-74 . 
Tape Volume New File (Minor Type 5) 
system log entry, 1-12 
Tape Volume Purged (Minor Type 3) system 
log entry, 1-12 
Tape Volume Used File (Minor Type 12) 
system log entry, 1-11, 3-70, 3-71, 
3-72, 3-73, 3-74 
TAPE WILL BE PURGED system message, 
A-24 
TAPE WRITE ERROR system message, 
A-25 
TAPECHECK security option, 1-8 
TAPEEXPIRATION (SYSOPS option) 
tape management systems and, 5-23 
TAPEEXPIRATION system option, 1-11, 
2-60 
TAPEMANAGER FAILED IN 
TERMINATION PROCEDURE 
system message, 5-38, A-26 
TAPEMANAGER FAILED . 
INITIALIZATION PROCEDURE 
system message, 5-38, A-~25 
TAPEMANAGER function name, 1-12 
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TAPEMANAGER IS ACTIVE system 
- message, A-26 
TAPEMANAGER IS INACTIVE system 
message, A-26 
TAPEMANAGER library 
binding procedures into library, 5-7 
changes to file attributes, recording, 1-11 
exported procedures, 1-12, 1-13, 5-23 
CHECK TAPE ASSIGNMENT, 5-25 
CHECK _TAPE PURGE, 5-30 - 
CHECK TAPE REOPEN, 5-32 
CHECK TAPE UNIT ASSIGNMENT, 
5-34 
CONTROL INTERFACE, 5-37 
effect of missing procedures, 5-13, 5-24 
PROGRAM INTERFACE, 5-39 
fault handling, 5-8 
by TAPEMANAGER itself, 5-9 
by the MCP 5-9 
freeze type, 5-7 
general considerations, 5-7 
general functions 
handling expired tapes, 5-23 
handling programmatic calls, 5-23 
opening files, 5-15 
purging tape volumes, 5-21 
shutting down, 5-14 
starting up, 5-12 
implementation of, 5-1 
initiated only by MCP 5-10 
interaction with MCP 5-11 
. invoked for nontape file opens, 5-17 
marking with an identity, 5-7, 5-56 
only one version allowed, 5-10 
opening tapes 
on a specific unit, 5-18 
reopening tapes, 5-20 
operations interface, 5-55 
initiating the library, 5-56 
inspecting library status, 5-56 
installing the library, 5-55 
replacing library with a new version, 
5-60 
responding to waiting processes, 5-59 
suspending use of the library, 5-58 
terminating the library, 5-57 
protected from DS commands, 5-57 
restrictions on database usage, 5-8 
sample program, 5-41 
security considerations, 5-10 
making code file private, 5-56 
status, 5-56, 5-58 
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GOINGAWAY, 5-58 
TERMINATING, 5-58 
WAITING TO DELINK, 5-58 
status changes, 5-11 
written in ALGOL or NEWP only, 5-7 
TAPEMANAGER LIBRARY HAS LINKED 
system message, A-26 
TAPEMANAGER LIBRARY IS ALREADY 
ACTIVE system message, 5-14, 
A-27 
TAPEMANAGER LIBRARY IS MISSING ... 
system message, 5-13, A-27 
TAPEMANAGER LIBRARY WILL NOT BE 
USED system message, 5-13, A~-27, 
A-28 
TAPEMANAGER REQUIRED system 
message, 5-59, A-28 
TAPEMANAGER system option, 2-60 
TAPEMANAGER INITIALIZATION 
. independent runner 
and TAPEMANAGER library 
implementation, 5-13 
calling CONTROL INTERFACE 
procedure, 5-14 
using RSVP message when linkage fails, 
5-13 
TAPEMANAGER TERMINATION 
independent runner 
actions taken to terminate 
TAPEMANAGER, 5-14 
invoking CONTROL INTERFACE 
procedure, 5-37 
tapes . | 
ANSI69 format, 1-9, 1-10, 3-8, B-2 


ANSI87 format, 1-9, 1-10, 3-8, 3-43, B-8, 


B-9, B-10, B-11, B-12, B-14, B-15, 
B-16, B-17 
creating, 3-43 
archive, defining scratch pools for, 1-2 
B 5500 format, B-19, B—20 
cartridge 
file protection mechanisms, 1-10 
Unisys HD600XTD, HD6150, 1-10 
write-enable status, 1-10 
dump, defining scratch pools for, 1-2 
examining before MCP assigns to tasks, 
1-7 
examples of, 1-7 
formats 
ANSI69, B-2 
ANSI87, 3-43, B-8 
B 5500, B-19, B-20 
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standard, B—1 
unlabeled, multifile, B—1 
unlabeled, single-file, B—1 
USASI B 3500, B-17 
grouped under common identifier, 1-2 
identifying 
by scratch pool name, 1-1 
by serial number, 1-1 
label formats, standard, B-1 
locking, 2-43 
multifile, multivolume 
ANSI69 format, B-3 
ANSI87 format, B-10 
purging, 1-2, 2-43 
asynchronously, 1-8 
examples of, 1-3 
synchronously, 1-8 
reel-to-reel 
write-enable status, 1-10 
rewinding, 1-1, 1-5 
scratch, 1-1, 1-2, 1-10 
ANSI69 format, B-6, B-8 
serial numbers, examples of changing, 
assigning, 1-3 
single-file, single-volume 
ANSI69 format, B-2 
standard formats, B-1 
unlabeled 
multifile, B—1 
single-file, B—1 
USASI B 3500 format, B-17 
write-enable status, 2—4 
5072 cartridge 
write-enable status, 1-10 
TAPESERVER system option, 2-60 
task 
abnormal termination, 2—22 
assignment, 1-7 
attributes 
LABELFORMAT, 1-9, 1-10, 3-7, 3-43 
EOT statistics, 2-29 
output, 1-10 
directing to device, 2-33 
TDIR (Tape Directory) system command, 
2-3 
TERMINATE system option, 2-22 
TERMINATING status, TAPEMANAGER 
library, 5-14, 5-56, 5-58 
time, operator verification of, 2~-26 
TITLE FOUND WAS system message, A-28 
TMS, (See tape management system 
(TMS)) 
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transaction state 
TAPEMANAGER library and, 5-8 
TRANSWARNINGS system option, 2-24 
TYPE DISAGREES WITH KIND system 
message, 5~19, A-29 


U 


Ustatus _ 
peripheral units, 2-37 
units, 2-37 
UL (Unlabeled) system command, 5-36 
causing CHECK TAPE UNIT_ 
ASSIGNMENT call, 
5-34 
detecting as source of UNITNO 
assignment, 5-20 
UNABLE TO LINK TO TAPEMANAGER 
LIBRARY system message, 5-13, 
A-29, A-30 
unattended tape management operations, 
1-5 
UNEXPECTED TAPE MARK system 
message, A-30 
UNINITIALIZED status 
peripheral units, 2-37 
units, 2-37 
Unisys HD600XTD, HD6150 tape cartridges 
write-protect plug, 1-10 
UNIT NOT VOLUMED system message, 
A-30 
unit requests, SETSTATUS 
- HOLD (Hold Unit for Operator Use), 3-33 
PG (Purge), 3-35 
PGL (Purge and Lock), 3-35 
SEND TAPEMANAGER, 3-31 
SEND TAPESERVER, 3-31 
SN (Serial Number), 3-39 
SNL (Serial Number Locked), 3-39 
UNITNO specified, in CHECK_TAPE UNIT 
ASSIGNMENT figure, 5-18 
units 
degraded reliability, 2—23 
status 
BLASTED, 2-37 
MAINTENANCE, 2-12 
. NOT READY, 2-12 
OFFLINE, 2-12 
ONLINE, 2-12 
READY, 2-12 
RESERVED, 2-12 
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U, 2-37 
UNINITIALIZED, 2-37 
UNLABELED, 2-37 


write-enable status, 2-4 


‘UNLABELED status 


peripheral units, 2-37 
units, 2-37 
unlabeled tapes, formats 
multifile, B—1 
single-file, B—1 
UNLINKED ACTION parameter 
CALL_TAPEMANAGER procedure, 5-54 
UNRESTRICT SOURCE AND REPLY OK 
TO COPY system message, A-14, 
A-30 
UPDATE statement, DUCONTROL, 4-3 
USASI format 
B 3500 file header 1, B-17 
B 3500 tape labels, B~-17 
USECATALOG file attribute, 2-30 
USECATDEFAULT system option, 2-30 
user header labels, ANSI69 tapes, B-2, B-8 
USER PROCESS FAULTED OR DSED IN 
TAPEMANAGER system message, 
5-9, 5-59, A~8, A~10, A-31 
user trailer labels, ANSI69 tapes, B—2, B-8 
utilities 
COPYAUDIT, 44, 4-6 
Data Management System II (DMSII), 
1-2, 4-2 
DUMPALL, 1-4 
FILECOPY, 1-4, 1-7 
using SCRATCHPOOL file attribute in, 
1-4 
VISIBLE DBS, 1-5, 4-6 


V 


VERIFY ERROR system message, A-32 
<visible dbs command>, 4—6 
VISIBLE DBS utility, 1-5, 4-6 
VOL (volume header) notation, tape label 
illustrations, B—1 
volume attributes 
FAMILYOWNER, 3-42 
SAVEFACTOR, 1-10 
SECURITYGUARD, 3-42 
SECURITYLABELS, 1-8, 1-9, 3-8, 3-42, 
3-43, 3-51, 3-53 
SECURITYTYPE, 3-42 
SECURITYUSE, 3-42 
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VOLUME DIRECTORY <action> NOT 
DONE system message, A-35 
VOLUME DIRECTORY FAULT IN 
VSHANDLER system message, A-34 
VOLUME DIRECTORY NOT SNED system 
message, A~35 
VOLUME DIRECTORY RECORD HAS 
INVALID DATA system message, 
A-34 | 
VOLUME DIRECTORY system message, 
A-33 
VOLUME FAMILY NOT DELETED system 
message, A-35 
volume header format 
ANSI69 tapes, B—4 
USASI B 3500 tapes, B—17 
volume header 1 format 
ANSI87 tapes, B—11 
volume header 2 format 
ANSI87 tapes, B-12, B-14 
volume header 3 format 
ANSI87 tapes, B-12, B-14 
VOLUME statement 
Work Flow Language (WFL), 3-51 
SECURITYLABELS volume attribute 
in, 1-8, 3-42 
Volume Status (LOGMAJVOL) system log 
entry, 1-11 
volumes 
multifile 
ANSI69 tape format, B-2 
ANSI87 tape format, B-9, B—10 
status 
system log entries, 3—70 


W 


waiting mix entries, status of, 2-45 

WAITING TO DELINK status, 
TAPEMANAGER library, 5-14, 
5-57, 5-58 

WARNING 56 system message, A-36 

WARNING 57 system message, A-37 

WARNING 58 system message, A-37 

WARNING 59 system message, A-37 

WARNING, TAPE WAS NOT WRITTEN 
WITH CHECKSUMS system 
message, A~35 

WARNING: TAPEMANAGER LIBRARY 
MISSING OBJECTS system 
message, 5-13, A~27, A-28, A-36 
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WEL, (See Work Flow Language (WFL)) 
Work Flow Language (WF L), 1-3, 3-43 


file attributes 
AUTOUNLOAD, 3-47, 3-51 
SCRATCHPOOL, 3-47, 3-51 
statements, 1-7 
ADD, 1-2, 1-3, 1-7, 3-47 


ARCHIVE, 1-2, 1-3, 3-45, 3-47 


COPY, 1-2, 1-3, 1-5, 1-7, 3-47 

FETCH, 2-26 

VOLUME, 1-8, 3-42, 3-51 
volume attributes 

FAMILYOWNER, 3-42 

SECURITYGUARD, 3-42 


SECURITYLABELS, 1-8, 3-42, 3-51, 


3-53 
SECURITYTYPEH, 3-42 
SECURITYUSE, 3-42 

write rings, 1-10 
write-enable status 
disks, 2-4 

tapes, 1-10 
units, 2—4 
write-protect plug 


Unisys HD600XTD, HD6150 tape 


cartridges, 1-10 
WRITEPARTNER specification 
host control (HC) unit, 24 
writing output to tape, 1-9, 1-10 


5078 cartridge tapes 
write enable status, 1-10 
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